Servidor MCP

Conecte seu assistente de IA (ChatGPT, Claude, Cursor…) à sua conta do Conttrole e emita notas fiscais conversando: “emita uma NFS-e de R$ 500 para o cliente X”. O assistente cria, emite, consulta, cancela e gera CC-e — falando direto com a sua conta via Model Context Protocol .

🔗 Servidor remoto, hospedado: https://mcp.conttrole.io — nada para instalar. Conecte por OAuth (login no navegador, sem manusear chave).

Conectar (OAuth — recomendado)

Ao conectar, o cliente de IA abre o login do Conttrole no navegador, você escolhe a empresa e autoriza as permissões. Pronto — sem chave, sem configuração de arquivo.

ChatGPT

Em Configurações → Conectores (modo desenvolvedor / planos com suporte a MCP), adicione um conector com a URL:


https://mcp.conttrole.io

Claude (claude.ai e Claude Desktop)

Em Configurações → Conectores → Adicionar conector personalizado, informe a URL:


https://mcp.conttrole.io

Cursor

No ~/.cursor/mcp.json (ou Settings → MCP):


{
  "mcpServers": {
    "conttrole": { "url": "https://mcp.conttrole.io" }
  }
}

Claude Code (CLI)


claude mcp add --transport http conttrole https://mcp.conttrole.io

Em todos, na primeira conexão o cliente abre o fluxo de login + autorização.

Autenticação por chave (alternativa)

Prefere não usar OAuth? Os clientes que permitem header customizado podem autenticar com uma chave de API (ck_live_...):


Authorization: Bearer ck_live_xxxxxxxxxxxx

Os escopos da chave valem aqui — uma ferramenta só funciona se a chave (ou a autorização OAuth) tiver o escopo correspondente (ex.: documents:write).

Ferramentas disponíveis

Ferramenta	O que faz
`list_fiscal_documents`	Lista documentos (filtra por status/tipo).
`get_fiscal_document`	Detalha um documento pelo id.
`create_fiscal_document`	Cria um documento; `emit=true` já emite.
`emit_fiscal_document`	Dispara a emissão (assíncrona).
`cancel_fiscal_document`	Cancela um documento autorizado (com justificativa).
`correct_fiscal_document`	Emite uma Carta de Correção (CC-e).
`get_fiscal_document_xml`	Baixa o XML autorizado.
`list_tax_rules`	Lista as regras tributárias.
`list_webhooks` / `create_webhook`	Gerencia webhooks.

Exemplo

“Crie uma NFS-e para o cliente cli_123 com um item de consultoria de R$ 500 e já emita.”

O agente chama create_fiscal_document (emit=true), recebe o runId e acompanha o status com get_fiscal_document.

Servidor local (avançado)

Quem usa Claude Desktop, Cursor ou Claude Code e prefere rodar o servidor na própria máquina (stdio) pode usar o pacote @conttrole/mcp:


{
  "mcpServers": {
    "conttrole": {
      "command": "npx",
      "args": ["-y", "@conttrole/mcp"],
      "env": { "CONTTROLE_API_KEY": "ck_live_xxxxxxxx" }
    }
  }
}

Para a maioria dos casos, o servidor remoto acima é mais simples (sem instalar nada, com OAuth) e funciona também na web (ChatGPT, claude.ai).