Documentação

Conecte sua IA ao Copilot via MCP

O servidor MCP (Model Context Protocol) da Bravonix expõe todas as ferramentas do Copilot como um serviço padrão, acessível por qualquer cliente MCP compatível.

Início rápido — 3 passos

1
Gere um token MCP
Acesse Configurações > MCP Tokens e clique em "Gerar novo token". Defina nome, escopo e expiração.
2
Copie o token (exibido apenas uma vez)
Guarde em local seguro. O token bruto não pode ser recuperado depois.
3
Configure seu cliente MCP
Escolha seu cliente abaixo e siga as instruções de configuração.

VS Code

Adicione ao seu settings.json:

{
  "mcpServers": {
    "compliancenow": {
      "url": "https://compliancenow.bravonix.ia.br/api/v1/mcp/sse",
      "headers": {
        "Authorization": "Bearer MCP_TOKEN_AQUI"
      }
    }
  }
}

Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "compliancenow": {
      "command": "npx",
      "args": ["-y", "@bravonix/mcp-server"],
      "env": {
        "MCP_TOKEN": "MCP_TOKEN_AQUI",
        "MCP_ENDPOINT": "https://compliancenow.bravonix.ia.br/api/v1/mcp"
      }
    }
  }
}

Cursor

Em Settings > Cursor Settings > MCP Servers, adicione:

{
  "mcpServers": {
    "compliancenow": {
      "url": "https://compliancenow.bravonix.ia.br/api/v1/mcp/sse",
      "headers": {
        "Authorization": "Bearer MCP_TOKEN_AQUI"
      }
    }
  }
}

Conexão STDIO (genérica)

Para qualquer cliente que suporte STDIO:

mcp connect stdio -- npx @bravonix/mcp-server --token MCP_TOKEN_AQUI

Conexão HTTP + SSE (genérica)

Headers necessários:

GET https://compliancenow.bravonix.ia.br/api/v1/mcp/sse
Authorization: Bearer MCP_TOKEN_AQUI

POST https://compliancenow.bravonix.ia.br/api/v1/mcp/message
Authorization: Bearer MCP_TOKEN_AQUI
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

Ferramentas disponíveis

Após conectar, seu cliente MCP terá acesso às seguintes ferramentas:

Ferramenta	Descrição
copilot_chat	Enviar mensagem para o Copilot e obter resposta
list_frameworks	Listar frameworks de compliance disponíveis
list_assessments	Listar assessments do usuário
get_evidence	Consultar evidências de conformidade
navigate_to_route	Navegar para uma rota autorizada na aplicação
create_assessment	Criar um novo assessment (requer escopo de escrita)

Boas práticas de segurança

Escopo mínimo: Crie tokens com o menor escopo necessário para a tarefa. Prefira leitura por padrão.
Rotação: Regenerar tokens periodicamente. Use a interface de administração para revogar tokens não utilizados.
Nunca compartilhe: O token MCP é pessoal e intransferível. Não o inclua em código versionado.
Expiração: Tokens não usados por mais de 90 dias são revogados automaticamente.
Limite: Máximo de 10 tokens ativos por usuário.

Solução de problemas

401 Unauthorized ao conectar

Verifique se o token não expirou ou foi revogado. Gere um novo token em Configurações > MCP Tokens.

Tool call retorna 403 Forbidden

O escopo do token não inclui permissão para esta ferramenta. Crie um novo token com escopo adequado.

Conexão recusada / timeout

Verifique sua conexão de internet e se a URL do servidor MCP está correta: https://compliancenow.bravonix.ia.br/api/v1/mcp/health

Status do servidor MCP

Servidor operacional — GET https://compliancenow.bravonix.ia.br/api/v1/mcp/healthOnline

Voltar ao início

Início rápido — 3 passos

Gere um token MCP

Acesse Configurações > MCP Tokens e clique em "Gerar novo token". Defina nome, escopo e expiração.

Copie o token (exibido apenas uma vez)

Guarde em local seguro. O token bruto não pode ser recuperado depois.

Configure seu cliente MCP

Escolha seu cliente abaixo e siga as instruções de configuração.