Ligue o servidor MCP, escolha as ferramentas e configure um cliente de IA com a chave da API.

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

Abra Configurações, depois Integrações.
Na seção Servidor MCP, ligue o servidor.
Revise as ferramentas. As de leitura vêm selecionadas, e as de escrita começam desligadas.
Ligue somente as ferramentas necessárias. Ferramentas de risco Alto pedem confirmação.
Clique em Salvar alterações.
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.

A versão 1.0 da OctoSolve autentica com uma chave no header Authorization. Clientes que aceitam servidores remotos somente por OAuth não conectam diretamente nesta versão. Isso inclui a configuração de conector personalizado nas interfaces web do Claude e do ChatGPT. Use um cliente que aceite headers personalizados, como os exemplos acima.

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.

Conectar