Conectar um agente

O endereço do servidor é sempre o mesmo:

https://mcp.brasilsintetico.com/mcp

Na maioria dos clientes basta colar esse endereço. O agente descobre o login sozinho e abre o app no navegador. Lá você entra na sua conta, escolhe o projeto e marca o que o agente pode fazer (como funciona). Não há chave para copiar. Sem conta, crie uma ali mesmo, só com nome, e-mail e senha: ela já vem com um primeiro projeto.

Os menus abaixo seguem a documentação oficial de cada cliente em outubro de 2026; os nomes podem mudar entre versões.

Claude (web e desktop)

Em Customize → Connectors, clique em + Add → Add custom connector.
Dê um nome (por exemplo, Brasil Sintético), cole o endereço do servidor e clique em Add.
Conecte e faça o login quando o Claude pedir.

Nos planos Team e Enterprise, quem é dono da organização adiciona o conector em Organization settings → Connectors, e cada pessoa clica em Connect depois. No plano Free, cabe um conector personalizado. Guia oficial: Getting started with custom connectors using remote MCP.

Claude Code

claude mcp add --transport http brasil-sintetico https://mcp.brasilsintetico.com/mcp

Depois, dentro do Claude Code, rode /mcp e escolha o servidor para fazer o login no navegador. Por padrão o servidor vale só para o projeto atual; use --scope user para todos os projetos, ou --scope project para gravá-lo no .mcp.json do repositório. Guia oficial: Connect Claude Code to tools via MCP.

ChatGPT

O ChatGPT conecta servidores MCP como apps personalizados, na web, nos planos Business, Enterprise e Edu. Quem cria o app é um admin ou dono do workspace; no Enterprise e no Edu, também quem o admin autorizar. Quem publica o app para o workspace é sempre um admin ou dono.

Ative o modo desenvolvedor.
- No Business, isso acontece ao criar o app, em Workspace settings → Apps → Create.
- No Enterprise e no Edu, vá a Settings → Apps → Advanced settings, depois que o admin liberar o acesso por papel.
Em Apps → Create, informe o endereço do servidor e escolha autenticação OAuth.
Clique em Scan Tools e faça o login quando o ChatGPT pedir.
Clique em Create. O app nasce como rascunho, e quem o criou já pode testá-lo.
Para o resto do workspace usar o app, um admin ou dono o publica em Workspace settings → Apps → Drafts → Publish.

O suporte completo ao MCP, com ferramentas que gravam, ainda está chegando em beta a esses planos. Num workspace que ainda não o recebeu, o app usa só as ferramentas de leitura: dá para consultar jobs e baixar resultados, mas não para enviar simulações.

O ChatGPT guarda uma cópia fixa das ferramentas aprovadas. Quando o Brasil Sintético acrescentar ou mudar ferramentas, um admin atualiza a lista nas configurações do app no workspace.

No Pro, o modo desenvolvedor só libera ferramentas de leitura: dá para listar, consultar e baixar, mas não para enviar simulações. O ChatGPT não aceita chave fixa, só o login. Guia oficial, em inglês: o modo desenvolvedor e os apps MCP no ChatGPT.

Cursor

Acrescente o servidor ao ~/.cursor/mcp.json (todos os projetos) ou ao .cursor/mcp.json do projeto, salve e reinicie o Cursor:

{
  "mcpServers": {
    "brasil-sintetico": {
      "url": "https://mcp.brasilsintetico.com/mcp"
    }
  }
}

O Cursor faz o login OAuth quando o servidor pede. Guia oficial: Model Context Protocol.

VS Code (GitHub Copilot)

Abra a paleta de comandos e rode MCP: Add Server.
Siga o fluxo guiado com o endereço do servidor. Para gravar, prefira .mcp.json (na raiz do projeto) ou Copilot Global (todos os projetos).
Faça o login quando o VS Code pedir. Ele usa o documento de metadados do cliente (CIMD), que este servidor aceita.

Guia oficial, em inglês: como adicionar e gerenciar servidores MCP no VS Code.

Agentes sem navegador

Um agente que roda num servidor, sem navegador para o login, usa uma chave de API do projeto no cabeçalho Authorization. As ferramentas respeitam os escopos da chave.

Claude Code, com a chave numa variável de ambiente:

claude mcp add --transport http brasil-sintetico https://mcp.brasilsintetico.com/mcp \
  --header "Authorization: Bearer $BS_API_KEY"

O shell expande a variável na hora, e a chave fica gravada na configuração do Claude Code. Para não gravá-la, use um .mcp.json que lê a variável ao conectar:

{
  "mcpServers": {
    "brasil-sintetico": {
      "type": "http",
      "url": "https://mcp.brasilsintetico.com/mcp",
      "headers": { "Authorization": "Bearer ${BS_API_KEY}" }
    }
  }
}

Cursor:

{
  "mcpServers": {
    "brasil-sintetico": {
      "url": "https://mcp.brasilsintetico.com/mcp",
      "headers": { "Authorization": "Bearer ${env:BS_API_KEY}" }
    }
  }
}

Qualquer outro cliente MCP que fale HTTP streamable funciona do mesmo jeito: com o login OAuth, pela descoberta padrão do MCP, ou com o cabeçalho Authorization: Bearer bs_….

Problemas comuns

O login abre e volta com erro de permissão. Quem é só leitor do projeto concede apenas results:read. Para simular, peça a um admin o papel de membro.
O agente diz insufficient_scope. O escopo não foi marcado no login. Desconecte o agente na página do projeto e conecte de novo, marcando o escopo.
401 com chave. Confira se a chave começa com bs_, se não foi revogada e se o projeto não está arquivado.