# Troubleshoot MCP (/mcp/troubleshooting)



Start by confirming that the client is configured with this exact endpoint:

```text
https://www.mogplex.com/api/v1/mogplex/mcp
```

## Common symptoms [#common-symptoms]

| Symptom                                       | What to check                                                                                                             |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Browser login succeeds but tools are missing  | Restart the agent session so it reloads the server catalog through `tools/list`.                                          |
| The client repeatedly requests authentication | Confirm both the server URL and explicit OAuth resource use the exact `www.mogplex.com` endpoint above.                   |
| `401 Unauthorized`                            | Re-run client login. The token may be expired, revoked, issued to an unapproved client, or minted for the wrong resource. |
| `403 Forbidden` with a PAT                    | Reissue the PAT with `write` when the requested tool mutates state.                                                       |
| Automation update returns `BAD_REQUEST`       | Send a complete graph with `nodes`, `edges`, and an optional valid `viewport`.                                            |
| Installation id returns `BAD_REQUEST`         | Use a positive safe integer returned by `mogplex_list_repos`.                                                             |
| An automation does not run the latest draft   | Publish the draft before triggering it. Triggers use the active published version.                                        |
| A model change is rejected                    | Use a model id currently returned by `mogplex_list_models`.                                                               |

## Re-authenticate a client [#re-authenticate-a-client]

### Codex [#codex]

```bash
codex mcp login mogplex
codex mcp get mogplex
```

### Claude Code [#claude-code]

Start Claude Code, run `/mcp`, select `mogplex`, and authenticate again.

### OpenCode [#opencode]

```bash
opencode mcp auth mogplex
```

For Cursor, open MCP settings, confirm the Mogplex server is enabled, and start
authentication again from the server controls.

## Verify PAT access directly [#verify-pat-access-directly]

When debugging a PAT-only client, initialize the endpoint directly:

```bash
curl -sS \
  -X POST \
  -H "Authorization: Bearer $MOGPLEX_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}' \
  https://www.mogplex.com/api/v1/mogplex/mcp
```

Do not paste the token or command output into a public issue. The
[Mogplex MCP endpoint reference](/reference/api#mcp-transport) documents the expected initialize
response and JSON-RPC errors.

## Next checks [#next-checks]

* Revisit [Install](/mcp/install) for the canonical client command.
* Review [Security](/mcp/security) for audience and scope rules.
* Review [Tools](/mcp/tools) for tool names and arguments.
* Use [Support](/support) if the client still cannot connect after a fresh login.