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):

Exemplo de configuração
{
  "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.

FerramentaO que fazQuando a IA usa
sea_searchPesquisar o conhecimento Sankhya do SEAFerramenta 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 projetoPara 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 especialistasCatá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 encaminhamentoDiagnó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 SEAVersã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.

ClienteAutenticaçãoStatusRevisado
ChatGPTOAuthValidado com restriçõesout/2026
Claude (web)OAuthValidadoout/2026
Claude DesktopOAuth ou API KeyValidadoout/2026
GeminiAPI Key ou OAuthValidado com restriçõesout/2026
Claude CodeOAuth ou API KeyValidadoout/2026
CodexOAuth ou API KeyValidadoout/2026
GitHub Copilot (agente)API KeyCompatibilidade a validarout/2026
GitHub Copilot CLIAPI KeyCompatibilidade a validarout/2026
GitLab DuoAPI KeyDepende do ambiente/planoout/2026
Amazon Q DeveloperAPI KeyCompatibilidade a validarout/2026
ClineAPI KeyCompatibilidade a validarout/2026
AntigravityAPI KeyValidado com restriçõesout/2026
VS CodeOAuth ou API KeyValidadoout/2026
JetBrainsAPI KeyDepende do ambiente/planoout/2026
CursorAPI KeyCompatibilidade a validarout/2026
WindsurfAPI KeyCompatibilidade a validarout/2026
EclipseAPI KeyCompatibilidade a validarout/2026
LovableAPI KeyDepende do ambiente/planoout/2026
ReplitAPI KeyDepende do ambiente/planoout/2026
Microsoft Copilot StudioAPI KeyDepende do ambiente/planoout/2026
Microsoft FoundryAPI KeyDepende do ambiente/planoout/2026
n8nAPI KeyCompatibilidade a validarout/2026
Vercel AI SDKAPI KeyCompatibilidade a validarout/2026
Aplicações própriasAPI KeyValidadoout/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.