Gemini

Gemini — Experts publicados no app, e o Gemini CLI conectado por MCP.

Como conectar

O endpoint é sempre o mesmo. O que muda de sistema para sistema é só onde a configuração entra.

1
No app: abra o Expert publicado
Em searchitect.pro/experts, cada Expert tem o botão de abrir no Gemini. Esse caminho não pede chave nem configuração — o assistente já está publicado.
2
Gere sua SEA API Key
Entre em searchitect.pro com sua conta, vá em Minha Conta → SEA API Keys e gere uma chave. Ela aparece uma única vez: copie e guarde em local seguro.
Formato da chave
sea_live_xxxxxxxxxxxxxxxxx

No Gemini CLI: adicione o servidor

O CLI aceita servidores MCP por comando, trocando SUA_CHAVE_SEA pela chave gerada:

gemini mcp add --transport http SEA-Systems-Enterprise-Architect https://mcp.searchitect.pro/mcp --header "Authorization: Bearer SUA_CHAVE_SEA"

Ou escreva a configuração direto

O arquivo de configuração do usuário fica em ~/.gemini/settings.json. Para servidores Streamable HTTP, a chave do objeto é httpUrl:

~/.gemini/settings.json

{
  "mcpServers": {
    "SEA-Systems-Enterprise-Architect": {
      "httpUrl": "https://mcp.searchitect.pro/mcp",
      "headers": {
        "Authorization": "Bearer sea_live_xxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Confirme

Dentro da sessão do CLI, liste os servidores e as ferramentas carregadas:

/mcp

Esperado

SEA-Systems-Enterprise-Architect — Connected
sea_search, sea_route, sea_experts, sea_version

São duas portas diferentes: no app do Gemini a cota é da sua conta Google e não há chave; no CLI vale a SEA API Key. Use httpUrl para o transporte Streamable HTTP — url é para servidores SSE.

Precisa da chave? Ela é exibida uma única vez ao ser gerada, e pode ser rotacionada ou revogada a qualquer momento.

Gerar minha API Key

Caso de uso

Traduzir uma demanda de negócio em requisito técnico

A situação

A área pede 'um relatório de margem por vendedor'. Ninguém sabe ainda se isso é um BI, uma consulta SQL ou um campo calculado.

O que você pede no Gemini

A área comercial pediu margem por vendedor no Sankhya. Quais tabelas e campos sustentam esse cálculo e quais caminhos existem para entregar isso?

O que volta

O Expert devolve a origem do dado e compara os caminhos possíveis com o custo de cada um. A conversa com a área passa a ser sobre escolha, não sobre viabilidade.

Teste se está funcionando

Primeiro um teste explícito, para confirmar que a ferramenta responde:

Use o SEA - Systems Enterprise Architect para analisar CRUDServiceProvider.loadRecords no Sankhya. Consulte o SEA antes de responder.

Depois o teste real, sem mencionar o SEA nem o Expert esperado. A ideia é verificar se o agente decide consultar o SEA automaticamente: ele deve chamar o servidor por conta própria, receber o roteamento do Core e responder com a evidência do Specialist.

Preciso consultar registros no Sankhya usando CRUDServiceProvider.loadRecords, retornando apenas alguns campos e aplicando critérios. Como devo estruturar essa chamada?

Deu 401 Unauthorized?

Confira, nesta ordem:

A chave foi copiada inteira, sem espaços nas pontas.
A chave não foi revogada nem rotacionada depois de configurada.
Sua conta Searchitect está ativa.
O acesso MCP está habilitado para a conta (mcp_enabled).
A chave não expirou.
O cliente realmente está enviando o header Authorization: Bearer.
No Claude web: o aplicativo não foi desconectado em Minha Conta → SEA API Keys. Se foi, refaça a conexão pelo próprio Claude.

Chaves revogadas e contas bloqueadas param de funcionar imediatamente. Se a chave se perdeu, rotacione-a em SEA API Keys — a antiga é invalidada na hora.

Conectar também

Não é esse o sistema que você usa?

Ver todas as conexões