Troubleshooting

Claude Code shows corpole as failed

The MCP server is listed but not connected. Usually Claude Code has neither a token nor an OAuth sign-in for it.

For: Team developer, Solo builder

Why it happens

The Corpole plugin sends a token when it finds one in CORPOLE_TOKEN or in ~/.config/corpole/token. Without a token it sends none, and Claude Code signs in with OAuth instead. If neither has happened yet, the server shows as failed or needing authentication.

Fix it

  1. Run /mcp, select corpole and choose Authenticate. Sign in to Corpole, pick the project and approve.
  2. Or set a token: create a personal token in Agents → Agent tokens, then either export CORPOLE_TOKEN in the shell Claude Code starts from, or save it to ~/.config/corpole/token.
  3. Restart the Claude Code session so it picks up the token.

Adding the server without the plugin

claude mcp add --transport http corpole https://corpole.com/api/mcp, then /mcp → Authenticate.