Insourcia

MCP (Model Context Protocol) é o protocolo padrão da Anthropic para conectar LLMs agentivos a fontes de dados / ações.

A Insourcia expõe um servidor MCP oficial: https://mcp.insourcia.io. Ele serve o mesmo catálogo de tools que /v1/rpc/tools, mas em protocolo MCP nativo.

O servidor também está listado no catálogo Smithery, utilizável via CLI deles (veja abaixo).

Dois métodos de autenticação

O servidor suporta duas formas de autenticação — escolha conforme seu cliente:

Método	URL MCP	Quando usar
OAuth	https://mcp.insourcia.io/mcp	Clientes que suportam OAuth (claude.ai, Smithery, ChatGPT MCP, Cursor). O cliente abre um fluxo de autorização na primeira chamada — sem chave em texto puro na configuração.
Chave de API na URL	https://mcp.insourcia.io/{votre-cle-api}	Clientes sem OAuth (Claude Desktop antigo, Mistral Le Chat, n8n, scripts). Zero etapa de login, funciona em qualquer lugar.

Para gerar ou recuperar sua chave de API (isk_…), abra Settings → API/MCP.

Clientes suportados

• Claude Code (CLI da Anthropic)
• Claude Desktop
• Cursor (IDE)
• Continue (extensão VSCode/JetBrains)
• Cline (extensão VSCode)
• Windsurf
• Qualquer cliente compatível com MCP

Adicionar ao Claude Desktop (método direto)

É o caminho mais simples e confiável, sem dependência externa:

1. Claude Desktop → Settings → Connectors → Add custom connector
2. Nome: Insourcia. URL:
   • OAuth: https://mcp.insourcia.io/mcp
     • ou chave na URL: https://mcp.insourcia.io/{votre-cle-api}
3. Add. Em OAuth, autorize o acesso na primeira chamada; com a chave na URL, é imediato.

A mesma lógica se aplica a Cursor, Continue, Cline, Windsurf: adicione um servidor MCP e cole a URL acima. Veja Configuração por cliente abaixo.

Via Smithery (toolbox)

A Insourcia está listada no Smithery. O Smithery agora funciona por toolbox: você adiciona a Insourcia à sua toolbox (botão Add to toolbox na página do servidor) e depois conecta a toolbox ao seu cliente. A autenticação é feita via OAuth para app.insourcia.io — nenhuma chave para copiar.

Na linha de comando:

npm install -g smithery
smithery mcp add insourcia/insourcia

O detalhe do fluxo toolbox evolui no lado do Smithery — consulte a documentação CLI deles. Se você quer apenas a Insourcia no Claude Desktop sem intermediário, use o método direto acima.

Configuração por cliente

Use o toggle para alternar entre os dois métodos de autenticação e copie a URL ou o comando correspondente ao seu cliente:

A chave está integrada à URL MCP. Nenhuma etapa de login, funciona em qualquer lugar.

Claude Desktop

1. Settings → Connectors → Add custom connector.
2. Nome Insourcia, URL MCP: https://mcp.insourcia.io/isk_VOTRE_CLE Copiar
3. Add. A conexão é imediata, nenhuma autenticação adicional é necessária.

Claude Code

CLI

1. No seu terminal: claude mcp add insourcia --transport http --url https://mcp.insourcia.io/isk_VOTRE_CLE Copiar
2. A conexão é imediata, nenhuma autenticação adicional é necessária.

ChatGPT

1. Settings → Apps → Developer mode.
2. Apps → Add app: https://mcp.insourcia.io/isk_VOTRE_CLE Copiar
3. Salve. A Insourcia fica disponível nas suas conversas.

Le Chat

Mistral

1. Intelligence → Connecteurs → Ajouter → MCP personnalisé.
2. Nome Insourcia, URL abaixo, auth desativada: https://mcp.insourcia.io/isk_VOTRE_CLE Copiar
3. Criar. A conexão é imediata.

HuggingChat

1. + → MCP Servers → Manage MCP Servers → + Add Server.
2. Nome Insourcia, URL: https://mcp.insourcia.io/isk_VOTRE_CLE Copiar
3. Add Server → Health Check. Ative o toggle.

Gemini CLI

CLI

1. No seu terminal: gemini mcp add insourcia --transport http --url https://mcp.insourcia.io/isk_VOTRE_CLE Copiar
2. A conexão é imediata, nenhuma autenticação adicional é necessária.

Para Cursor / Continue / Cline: Settings → MCP → Add server → cole a URL acima conforme o modo escolhido.

Tools disponíveis

Idênticas à superfície Tools RPC:

18 tools, idênticas no servidor MCP e na superfície Tools RPC. Referência interativa com try-it-now em /docs/tools.

Descoberta

Tool	Ação
search_companies	Pesquisa de empresas
resolve_companies	Correspondência de um arquivo
search_directors	Pesquisa de dirigentes
search_director_companies	Impressão digital de um dirigente

Perfil

Tool	Ação
get_company	Ficha da empresa
get_directors	Dirigentes e mandatos
get_company_graph	Mapeamento de grupo

Finanças

Tool	Ação
get_financials	Balanços e contas anuais
get_credit_risk	Score de risco de crédito

Vigilância legal

Tool	Ação
search_events	Pesquisa de eventos
get_events	Linha do tempo de uma empresa

Monitoramento

Tool	Ação
create_saved_search	Pesquisa salva
list_saved_searches	Minhas pesquisas salvas
watch_company	Colocar sob monitoramento
list_watched_companies	Minhas empresas monitoradas
unwatch_company	Remover do monitoramento
get_news	Feed de vigilância
mark_news_read	Sinais processados

Exemplos de uso

No Claude Code:

> Trouve-moi les 10 plus grosses sociétés de software en Île-de-France
  qui n'ont pas reçu de fonds depuis 3 ans

[Claude appelle search_companies en interne]

> Donne-moi le bilan 2023 de Vinci

[Claude appelle search_companies → get_financials en chaîne]

MCP vs Tools RPC

	MCP	Tools RPC
Protocolo	MCP (JSON-RPC over HTTP/stdio)	REST HTTP padrão
Público	Clientes compatíveis com MCP	Qualquer cliente HTTP
Descoberta	tools/list nativo	GET /v1/rpc/tools
Auth	Bearer / OAuth	Bearer

Se seu cliente suporta MCP, use MCP — a experiência é mais direta (o LLM vê as tools nativamente, sem precisar colar uma OpenAPI). Caso contrário, Tools RPC.