Troubleshooting

My agent sees the wrong solution, or none

Every connection belongs to exactly one solution. The agent sees the solution its token was created in, or the one chosen on the OAuth consent screen.

For: Team developer

Fix it

With OAuth: ask the agent to call switch_solution with the solution's key or name, or reconnect (/mcp → Authenticate in Claude Code) and pick the right solution on the consent screen.
With a token: use a token created in the right solution's Agents → Agent tokens. A token cannot switch solutions.
Right solution, wrong initiative: new work goes to the session's initiative. Ask the agent to call select_initiative with the right one.
A solution that is not active refuses every connection; see 401 invalid_token.