| Problem |
Fix |
| The Nysa tools don’t appear |
Start a new conversation or session after connecting. Your agent’s MCP list (/mcp in Claude Code, codex mcp list, hermes mcp test nysa) shows whether the connection works. |
| Nysa isn’t in Claude Connectors |
Choose Add custom connector and paste https://mcp.usenysa.com/mcp. |
| Nysa isn’t in ChatGPT Apps |
Turn on Developer mode under Apps → Advanced settings and create an app with https://mcp.usenysa.com/mcp. |
| Sign-in loops or fails |
Remove Nysa from your agent, add it again, and sign in with the Google account your workspace uses. |
| Problem |
Fix |
401 invalid_token or “Your API key is no longer valid” |
The key is expired, revoked, or copied wrong. Create a new key and update NYSA_API_KEY. |
| “This API key is read-only” |
The agent tried to write. Create a Read and write key. |
| “… is not available for this API key” |
The key is limited to certain projects or scopes. Create a key with the access the agent needs. |
| Problem |
Fix |
| Meetings or people are missing |
Your agent sees only what you can see. Ask your workspace owner if something should be visible. |
| Results say “unavailable” |
You may no longer belong to the workspace, or the item was removed. Ask your workspace owner. |
| Recent email is missing |
Your Gmail may still be importing. Try again later. |
Still stuck? Email hello@usenysa.com.
