Skip to main content
Resumo: MCP (Model Context Protocol) é o padrão aberto criado pela Anthropic para conectar LLMs a ferramentas externas. O MCP Server da GYRA+ expõe a API da plataforma como tools que Claude, ChatGPT, Cursor ou qualquer cliente compatível podem chamar em linguagem natural. Isso permite rodar análises, consultar relatórios e configurar a plataforma por conversa.

​
O que é MCP

Agentes de IA precisam de duas coisas para serem úteis: conhecimento (o que eles sabem, vem do treinamento) e ferramentas (o que eles podem fazer, vem de integrações). MCP padroniza a segunda parte: em vez de cada LLM ter seu próprio protocolo de tools, todos falam MCP. Um MCP Server publica um conjunto de ferramentas (tools) documentadas com schema JSON. Um MCP Client (Claude Desktop, Cursor, VS Code via Continue, LangChain, etc.) consome esse catálogo e expõe as tools ao modelo. Quando o usuário pede algo, o modelo decide qual tool chamar, com quais argumentos, e encadeia chamadas até concluir a tarefa.

​
O que o MCP da GYRA+ oferece

O servidor MCP da GYRA+ expõe os fluxos principais da plataforma como tools:
  • Rodar análises: create_report
  • Análise manual: analyze_report, re_analyze_report
  • Consultar relatórios: list_reports, get_report, count_reports, get_section, get_report_section_by_type
  • Políticas: list_policies
  • Webhooks: create_webhook, find_webhooks, delete_webhook
  • Export: export_report_sync
  • Autenticação: authenticate
Lista completa com schemas em Ferramentas Disponíveis.

​
Quando faz sentido usar

Analistas em ferramenta conversacional

Analista pergunta “roda essa análise pra mim” no Claude, o MCP traduz em create_report e devolve o resultado.

Agentes autônomos

Worker monitora um e-mail, detecta CNPJs novos e dispara análises sem intervenção humana.

Prototipação rápida

Testar integrações sem escrever backend. O agente vira um “cliente API” na conversa.

Análise em dataset

Agente lê uma planilha de CNPJs, cria lote, consulta resultado, escreve o de volta.

​
Quando não usar

  • Integração de produção em alto volume: use API REST direta. MCP tem overhead de modelo LLM no meio, não é o melhor path para milhares de requisições por minuto.
  • Fluxos críticos sem humano: LLM pode cometer erro de interpretação. Não use MCP para tarefas onde um erro é caro e não há review.
  • Ambientes regulados sem auditoria: toda chamada via MCP é mediada pelo modelo, o log de auditoria precisa ser pensado com cuidado.

​
Clientes MCP compatíveis

O protocolo é aberto, qualquer cliente MCP-compliant funciona. Os mais comuns:
  • Claude Desktop (Anthropic), MacOS e Windows
  • Cursor (IDE)
  • VS Code via extensão Continue
  • Claude Code (CLI)
  • LangChain, LlamaIndex (frameworks de agentes)
  • Implementações próprias via SDK oficial (Python, TypeScript, Rust)

​
Autenticação

Toda tool exige autenticação com o seu login da plataforma: o mesmo e-mail e senha que você usa no toolbox. Duas formas de conectar:
  1. Custom connector (OAuth) no Claude.ai/Claude Desktop: você adiciona o endpoint, clica em Authenticate e faz login na página da GYRA+. A senha não fica gravada em lugar nenhum do seu lado.
  2. Stdio local em Claude Code, Cursor, VS Code, SDKs: e-mail e senha em variáveis de ambiente (GYRA_CLIENT_ID + GYRA_CLIENT_SECRET), com renovação automática de sessão.
Não há credencial para solicitar: você entra com o e-mail e a senha que já usa no toolbox, e o agente herda as suas permissões. Detalhes em Instalação.

​
Segurança

  • O agente opera com as suas permissões, não com as da organização. Se você não enxerga um relatório no toolbox, o agente também não enxerga. Não existe escalonamento de privilégio por usar o MCP.
  • No modo custom connector (OAuth), o Claude armazena as credenciais de forma cifrada e o servidor MCP recebe apenas um token de sessão revogável.
  • Toda chamada é auditada no backend identificando o usuário que a originou, não uma credencial genérica de integração.
  • No modo stdio, as credenciais ficam no cliente (Claude Desktop, Cursor, etc.), nunca no servidor MCP.
  • O escopo disponível corresponde ao que a organização tem contratado. Features não contratadas retornam erro claro.

​
Perguntas frequentes

Não. Complementa. A REST é a fundação; MCP é uma camada de acesso via agente. Para automação de alto volume, continue usando REST direto.
Do lado GYRA+, nenhum além das análises que o agente chama (cobradas normalmente pelo consumo padrão). Do lado do cliente LLM, custo do modelo (tokens) que você já paga à Anthropic/OpenAI/etc.
Claude Desktop e Cursor aceitam configuração via JSON em um arquivo de settings. Ver Instalação. Após instalar, o uso é 100% conversacional.
Sim, desde que o cliente seja MCP-compatível e o modelo tenha capacidade de tool calling. Modelos menores podem ter qualidade inferior na escolha de tools.
O servidor MCP da GYRA+ é operado pela GYRA+. Você instala o cliente (Claude Desktop, etc.) e aponta para nosso endpoint. Não há instalação server-side do seu lado.

​
Próximos passos

Instalação

Configurar Claude Desktop, Cursor ou outro cliente.

Ferramentas disponíveis

Catálogo completo de tools com schema.

Casos de uso

Exemplos práticos de conversa.

Troubleshooting

Problemas comuns e soluções.