Troubleshooting

MCP Server Does Not Appear

Check that:

• the config file was written to the expected location
• the client supports MCP in the way you configured it
• the client was restarted after config changes

Connected to the Wrong Project

This usually means the generated config and your OpenSana profile do not match.

Verify:

• current repo path
• selected profile
• deployment URL
• project identity

Auth or Permission Errors

Confirm that:

• your API key is still valid
• the key belongs to the intended user
• the user can access the target organization and project

CLI Config Exists but MCP Still Fails

Remember that CLI setup and MCP setup are related but different:

• setup saves profile information
• init mcp writes client-facing MCP config

You need both pieces aligned.

Next Step

If the client still cannot use MCP tools reliably, regenerate the config from a clean working directory and test basic task read operations first.