Liga a SuperCognit ao Gemini CLI
O Gemini CLI carrega servidores MCP a partir do settings.json e suporta servidores remotos por streamable HTTP. Adiciona o teu workspace SuperCognit e o Gemini pode listar e editar agentes, construir bases de conhecimento, anexar ferramentas e ler conversas — a partir do terminal, com uma chave de API do workspace ou OAuth.
Dados de ligação
// ~/.gemini/settings.json
{
"mcpServers": {
"supercognit": {
"httpUrl": "https://mcp.supercognit.com/platform/<workspace>/mcp",
"headers": { "x-api-key": "<api-key>" }
}
}
}Substitui <workspace> pelo slug do workspace mostrado em Integrações → Platform MCP, e <api-key> por uma chave de API do workspace quando o teu cliente não inicia sessão por OAuth. Os servidores MCP publicados ligam-se da mesma forma no seu próprio URL.
O que podes fazer depois de ligar
Alterações ao workspace por script
Atualiza as instruções de vários agentes, roda uma fonte de conhecimento ou anexa uma ferramenta nova — descrito uma vez, aplicado pelo Gemini por MCP.
Conhecimento a partir de ficheiros locais
O Gemini CLI lê a tua documentação no disco e envia-a como fontes para uma base de conhecimento da SuperCognit.
Verificação diária da utilização
Pede as conversas desta semana, a utilização de créditos e as principais perguntas, e manda o Gemini escrever o resumo num ficheiro.
Ferramentas para APIs alojadas na Google
Regista os teus endpoints do Cloud Run ou do Apps Script como ferramentas SuperCognit para o teu agente de clientes os poder chamar.
Como ligar
1. Copia o URL MCP do teu workspace
Integrações → Platform MCP no painel. Um URL por workspace.
2. Adiciona o servidor ao settings.json
Em ~/.gemini/settings.json (ou no .gemini/settings.json do projeto) adiciona uma entrada supercognit em mcpServers com httpUrl definido para o URL do workspace.
3. Autentica
O mais simples: uma chave de API do workspace no objeto headers como x-api-key. O Gemini CLI também consegue correr o início de sessão OAuth para servidores remotos se o ativares na entrada.
4. Verifica com /mcp
Corre /mcp dentro do Gemini CLI para ver o servidor e as suas ferramentas, e depois pede-lhe para listar os teus agentes.
Perguntas frequentes
Usa httpUrl — é a chave do Gemini CLI para servidores streamable HTTP. url é para SSE, que a SuperCognit não serve.
Painel → Integrações → API. As chaves são por workspace e podem ser só de leitura; mantém-nas fora de ficheiros de definições guardados no repositório.
Pode alterar o estado de um produto se a chave ou o papel o permitir. Muitas equipas mantêm chaves de leitura e escrita, mas deixam a publicação como um clique no painel.
O modo agente do Code Assist no IDE lê as mesmas definições, por isso o servidor da SuperCognit também fica disponível aí.
O teu workspace a um URL MCP de distância
Cria um workspace, copia o URL MCP em Integrações → Platform MCP, cola-o no teu agente — grátis durante 7 dias.
Começar a construirClaude
Adiciona o teu workspace SuperCognit ao Claude como conector personalizado: cria agentes, atualiza bases de conhecimento e lê a tua caixa de entrada a partir de um chat do Claude, com um único início de sessão OAuth.
Claude Code
Adiciona o teu workspace SuperCognit ao Claude Code com um comando. Cria agentes, atualiza bases de conhecimento e liga ferramentas a partir do terminal, com OAuth ou uma chave de API do workspace.
Claude Cowork
Dá ao Claude Cowork acesso ao teu workspace SuperCognit: pode criar agentes, atualizar o conhecimento e reportar sobre as conversas como parte de uma tarefa mais longa no teu desktop.