Conectar ao servidor MCP

Você precisa de um plano Plus ou Pro e de uma chave da API. Crie uma chave read se a IA só vai consultar dados. Use uma chave write somente quando ela precisar criar ou alterar dados.

Ligar na OctoSolve

1. Abra Configurações, depois Integrações.
2. Na seção Servidor MCP, ligue o servidor.
3. Escolha as ferramentas. A tela abre com as 16 de leitura já marcadas como sugestão e as de escrita desmarcadas. A sugestão só vale depois de salvar: antes disso a conta não tem configuração gravada e nenhuma ferramenta responde.
4. Ligue somente as ferramentas necessárias. Ferramentas de risco Alto pedem confirmação.
5. Clique em Salvar alterações.
6. Copie o endereço do servidor e escolha uma chave da API com o escopo adequado.

Use estes dados em qualquer cliente compatível:

Endereço: https://api.octosolve.com.br/mcp
Autenticação: Authorization: Bearer osk_live_EXEMPLO_FICTICIO_NAO_USE_000000000000
Transporte: Streamable HTTP

Substitua a chave fictícia pela sua chave. Nunca compartilhe a chave em conversa, repositório, captura de tela ou arquivo sincronizado.

VS Code com GitHub Copilot

Execute MCP: Open User Configuration na paleta de comandos e use:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "octosolve-api-key",
      "description": "Chave da API da OctoSolve",
      "password": true
    }
  ],
  "servers": {
    "octosolve": {
      "type": "http",
      "url": "https://api.octosolve.com.br/mcp",
      "headers": {
        "Authorization": "Bearer ${input:octosolve-api-key}"
      }
    }
  }
}

Inicie o servidor e informe a chave quando o VS Code pedir. Depois, abra o Chat no modo Agent e confira as ferramentas em Configure Tools.

Claude Code

Defina a chave numa variável de ambiente chamada OCTOSOLVE_API_KEY. Depois adicione esta configuração ao MCP do Claude Code:

{
  "mcpServers": {
    "octosolve": {
      "type": "http",
      "url": "https://api.octosolve.com.br/mcp",
      "headers": {
        "Authorization": "Bearer ${OCTOSOLVE_API_KEY}"
      }
    }
  }
}

Reinicie a conexão e use /mcp para conferir o servidor e as ferramentas.

Cursor

Abra a configuração global do MCP do Cursor e adicione:

{
  "mcpServers": {
    "octosolve": {
      "url": "https://api.octosolve.com.br/mcp",
      "headers": {
        "Authorization": "Bearer osk_live_EXEMPLO_FICTICIO_NAO_USE_000000000000"
      }
    }
  }
}

Troque a chave fictícia pela sua chave e mantenha essa configuração fora de projetos compartilhados. Reinicie o servidor MCP nas configurações do Cursor e confira a lista de ferramentas disponíveis.

OpenAI Responses API

Em uma aplicação que usa a Responses API, envie o servidor como ferramenta MCP. A chave da OctoSolve deve existir somente no ambiente do servidor da sua aplicação:

import OpenAI from "openai";
 
const openai = new OpenAI();
 
const resposta = await openai.responses.create({
  model: "gpt-5",
  input: "Liste os próximos agendamentos.",
  tools: [
    {
      type: "mcp",
      server_label: "octosolve",
      server_url: "https://api.octosolve.com.br/mcp",
      headers: {
        Authorization: `Bearer ${process.env.OCTOSOLVE_API_KEY}`,
      },
      require_approval: "always",
    },
  ],
});
 
console.log(resposta.output_text);

Mantenha aprovação obrigatória enquanto houver ferramenta de escrita ligada.

Clientes que exigem OAuth

O servidor aceita dois caminhos de autenticação, e os dois chegam no mesmo lugar:

Para o caminho OAuth, basta cadastrar https://api.octosolve.com.br/mcp como conector. O cliente descobre sozinho o servidor de autorização, se registra e abre a tela de consentimento da OctoSolve. Quem aprova é o dono da conta, com o login normal.

O que o servidor publica na descoberta:

https://api.octosolve.com.br/.well-known/oauth-protected-resource/mcp
https://api.octosolve.com.br/.well-known/oauth-authorization-server

A autorização concedida aparece em Configurações > Integrações > Aplicativos conectados, e remover ali corta o acesso na hora. Chave da API não aparece nessa lista: ela se revoga na seção de chaves.

Uso no navegador

Não conecte uma página web diretamente ao servidor MCP. Além de expor a chave da API no navegador, origens arbitrárias não são liberadas. A conexão deve partir do cliente de IA ou do servidor da sua aplicação.

Testar a conexão

Comece com uma chave read e pergunte:

Quais serviços ativos estão disponíveis?

Se a lista aparecer, teste uma consulta de agenda. Ligue ferramentas de escrita somente depois de revisar os riscos em Ferramentas.

Se você mudar as ferramentas, trocar a chave ou fizer upgrade de plano, desconecte e conecte o cliente novamente. Antes de investigar qualquer falha, confirme na tela que o servidor MCP continua ligado: com ele desligado nenhuma reconexão resolve.