Documentação · SEA MCP
SEA MCP: referência pública
O SEA MCP é o servidor Model Context Protocol do SEA. Um cliente de IA compatível com MCP (Claude, ChatGPT, Codex, Cursor, VS Code e outros) se conecta a ele e passa a consultar 25 especialistas em Sankhya ERP, coordenados pelo SEA Agent Core, durante o trabalho. O SEA entrega conhecimento e evidência; o modelo de IA continua sendo o seu.
Conferido no servidor em produção em 5 de novembro de 2026 (versão 0.21.7).
Para que serve e para quem
Modelos de IA genéricos conhecem pouco do Sankhya ERP: tabelas, serviços, regras fiscais e o jeito certo de customizar. Com o SEA MCP, a sua IA busca a evidência num especialista do domínio antes de responder, com a fonte e o nível de confiança — e avisa o que precisa ser conferido no seu ambiente.
- Desenvolvedores e consultores técnicos: SDK, APIs, integrações, SQL, telas HTML5 e relatórios.
- Consultores funcionais e analistas de suporte: fiscal, financeiro, comercial, estoque, WMS, RH e outros módulos.
- Equipes que usam agentes de código (Claude Code, Codex, Cursor) em projetos Sankhya.
Arquitetura: Client Agent → SEA MCP → Agent Core → Specialist Experts. Ver os especialistas.
Endpoint e conexão
- Endpoint
- https://mcp.searchitect.pro/mcp
- Transporte
- Streamable HTTP (servidor remoto, sem instalação)
- Nome sugerido
- SEA-Systems-Enterprise-Architect
- Sem credencial
- O endpoint responde 401 e indica o servidor de autorização.
Claude Code, com login pelo navegador:
claude mcp add --transport http --scope user SEA-Systems-Enterprise-Architect https://mcp.searchitect.pro/mcp
Clientes que leem um arquivo de configuração MCP, com a SEA API Key no cabeçalho (o formato exato muda de cliente para cliente):
{
"mcpServers": {
"SEA-Systems-Enterprise-Architect": {
"type": "http",
"url": "https://mcp.searchitect.pro/mcp",
"headers": { "Authorization": "Bearer SUA_CHAVE_SEA" }
}
}
}O roteiro exato de cada cliente está em Conexões e o passo a passo com as telas, no guia do SEA MCP.
Autenticação e permissões
- Uma conta no SEA (app.searchitect.pro) com o acesso pelo MCP ativo.
- Conexão por login (OAuth): o cliente abre a página do SEA, você entra e autoriza; o cliente recebe um acesso temporário, revogável em SEA MCP → Chaves e apps → Apps conectados.
- Ou uma SEA API Key, enviada pelo cliente no cabeçalho Authorization: Bearer. A chave é pessoal: não a coloque em repositório nem em arquivo compartilhado.
- Nenhuma permissão sobre o seu computador, o seu código ou o seu ERP: o SEA recebe só a pergunta que a sua IA envia.
Descoberta OAuth para clientes que registram sozinhos (PKCE S256 e registro dinâmico de cliente):
- https://mcp.searchitect.pro/.well-known/oauth-protected-resource
- https://searchitect.pro/.well-known/oauth-authorization-server
Ferramentas
5 ferramentas públicas, todas declaradas ao cliente como somente leitura, não destrutivas e sem acesso a sistemas de fora. A sua IA decide quando chamar cada uma.
| Ferramenta | O que faz | Quando a IA usa |
|---|---|---|
sea_searchPesquisar o conhecimento Sankhya do SEA | Ferramenta principal. Recebe a pergunta técnica ou funcional sobre o Sankhya ERP (pode incluir a mensagem de erro inteira) e devolve a evidência do especialista escolhido pelo Agent Core, com o nível de confiança e um trecho de apoio de outro especialista quando a pergunta cruza domínios. | Sempre que a pergunta for sobre o Sankhya ERP: fiscal, financeiro, estoque, WMS, SDK, APIs, SQL, telas, relatórios e o resto. |
sea_preparePreparar o contexto do projeto | Para tarefas sobre o projeto do próprio cliente (repositório ou documentos que a IA do cliente acessa): confirma a conexão e devolve os passos para a IA montar, no ambiente do cliente, o grafo de contexto do projeto. O SEA não recebe o projeto. | Uma vez por conversa, quando a tarefa envolve o material do projeto. |
sea_expertsListar os especialistas | Catálogo dos 25 especialistas, com domínio e situação do conhecimento, e a política de evidência comum. | Quando a pessoa pergunta o que o SEA cobre ou quer escolher um especialista específico. |
sea_routeVer o encaminhamento | Diagnóstico: mostra para qual especialista o Agent Core encaminharia uma pergunta, sem pesquisar. | Só para diagnóstico; não é necessária antes da sea_search. |
sea_versionVersão e estado do SEA | Versão do serviço e estado da conexão. | Para conferir se a conexão está funcionando. |
Clientes suportados
O status diz o que confirmamos do nosso lado, não o que o fabricante promete. “Compatibilidade a validar” quer dizer roteiro baseado na documentação do cliente, ainda sem conexão confirmada por nós.
| Cliente | Autenticação | Status | Revisado |
|---|---|---|---|
| ChatGPT | OAuth | Validado com restrições | out/2026 |
| Claude (web) | OAuth | Validado | out/2026 |
| Claude Desktop | OAuth ou API Key | Validado | out/2026 |
| Gemini | API Key ou OAuth | Validado com restrições | out/2026 |
| Claude Code | OAuth ou API Key | Validado | out/2026 |
| Codex | OAuth ou API Key | Validado | out/2026 |
| GitHub Copilot (agente) | API Key | Compatibilidade a validar | out/2026 |
| GitHub Copilot CLI | API Key | Compatibilidade a validar | out/2026 |
| GitLab Duo | API Key | Depende do ambiente/plano | out/2026 |
| Amazon Q Developer | API Key | Compatibilidade a validar | out/2026 |
| Cline | API Key | Compatibilidade a validar | out/2026 |
| Antigravity | API Key | Validado com restrições | out/2026 |
| VS Code | OAuth ou API Key | Validado | out/2026 |
| JetBrains | API Key | Depende do ambiente/plano | out/2026 |
| Cursor | API Key | Compatibilidade a validar | out/2026 |
| Windsurf | API Key | Compatibilidade a validar | out/2026 |
| Eclipse | API Key | Compatibilidade a validar | out/2026 |
| Lovable | API Key | Depende do ambiente/plano | out/2026 |
| Replit | API Key | Depende do ambiente/plano | out/2026 |
| Microsoft Copilot Studio | API Key | Depende do ambiente/plano | out/2026 |
| Microsoft Foundry | API Key | Depende do ambiente/plano | out/2026 |
| n8n | API Key | Compatibilidade a validar | out/2026 |
| Vercel AI SDK | API Key | Compatibilidade a validar | out/2026 |
| Aplicações próprias | API Key | Validado | out/2026 |
Outro cliente compatível com MCP remoto? Roteiro genérico.
Limites
- O SEA entrega conhecimento e evidência; quem responde é a IA do cliente. A resposta final precisa ser conferida no ambiente da empresa, principalmente em regra fiscal, configuração e versão.
- O SEA não acessa a base do Sankhya do cliente nem executa nada no ERP pelo MCP: as ferramentas são somente leitura e não alteram dados.
- O SEA não exporta documentos inteiros nem a base de conhecimento: devolve trechos de evidência para a pergunta feita.
- Quando nenhum especialista cobre o assunto, o Agent Core pede esclarecimento ou declara a falta de cobertura, em vez de escolher um especialista qualquer.
- O acesso pelo MCP é por assinatura pré-paga e segue a política de uso justo.
- Cada cliente de IA tem as próprias regras de plano e de liberação de MCP: a página de cada conexão diz o que confirmamos.
Mais em Uso justo, Privacidade e Preços.
Pronto para conectar?
Escolha o seu cliente de IA e siga o roteiro. Assinatura via Pix · sem fidelidade.