Troubleshooting
Error messages
Sinfonia MCP messages are returned in Portuguese. The table shows each message with its translation.
| Message | Cause | What to do |
|---|---|---|
| Sessão expirada ou revogada. Reconecte o Sinfonia no seu cliente MCP para fazer login de novo. (Session expired or revoked.) | The 24-hour session ended or was terminated. | Sign in again from the client (see below). |
| Seu Perfil no Sinfonia não tem permissão para isso. (Your Profile doesn’t have permission.) | Your Profile doesn’t allow this action on the platform. | Ask an administrator to review your Profile in Users. |
| Não encontrado nesta Conta. (Not found in this Account.) | The bot, execution or agent doesn’t exist in your Account. | Check the name or number. Some tools require the exact bot or agent name. |
| O Sinfonia recebeu requisições demais. (Too many requests.) | Request limit reached. | Wait a few seconds and try again. |
| O Sinfonia respondeu com erro (HTTP …). (Sinfonia responded with an error.) | Unexpected platform failure. | Try again. If it persists, contact support. |
Sign in again
| Client | How to reconnect |
|---|---|
| Claude Code | Run /mcp, select sinfonia and choose Authenticate. |
| Claude Desktop / claude.ai | In Settings → Connectors, disconnect and reconnect Sinfonia. |
| Codex | codex mcp login sinfonia |
| Gemini CLI | /mcp auth sinfonia |
| Cursor / VS Code | Use the connect or restart server option in the MCP settings. |
Common issues
The verification code doesn’t work. The code is valid for 90 seconds. If it expires, go back and sign in again to receive a new one. Also check your spam folder.
I have to sign in every day. That’s expected: the session lasts 24 hours.
The browser doesn’t open (SSH or remote server). Command-line clients open the browser on the machine where they run. Over SSH, set up port forwarding or use the client on your local machine.
The client only offers SSE or stdio. Sinfonia MCP uses Streamable HTTP only. Update the client to a version that supports remote MCP over HTTP with OAuth.
The assistant can’t find Sinfonia’s tools. Check that the server shows as connected in the client’s MCP list and that sign-in reached the authorization screen. Some clients need a restart after adding a server.
An admin tool is missing or returns a permission error.
resumo_dashboard and consultar_logs_agente are available only to the Admin and Dev Profiles. See Tools and permissions.