Insourcia
Inteligência empresarial francesa: pesquise empresas francesas por nome ou SIREN/SIRET, obtenha dados financeiros, diretores, gráficos de propriedade, eventos de fusões e aquisições e insolvência.
Documentação
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 endereços: completo e diretórios
A Insourcia serve duas versões do seu servidor MCP, no mesmo domínio, com a mesma conta e a mesma autenticação:
| Endereço | Para quem | Conteúdo |
|---|---|---|
https://mcp.insourcia.io/mcp | Conector adicionado manualmente (custom connector), clientes MCP, Smithery | A versão completa, recomendada para uso direto. |
https://mcp.insourcia.io/mcp/directory | Versão listada nos diretórios do ChatGPT e do Claude | As mesmas tools, sem os dados pessoais não necessários para a análise empresarial: sem perfil LinkedIn, data de nascimento dos dirigentes apenas com o mês, sem local de nascimento. |
Se você adicionou a Insourcia pelo diretório do ChatGPT ou do Claude, você está usando a segunda. Para a versão completa, adicione um conector personalizado com https://mcp.insourcia.io/mcp. Uma conexão OAuth vale para os dois endereços.
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 exposta 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:
- Claude Desktop → Settings → Connectors → Add custom connector
- Nome:
Insourcia. URL:- OAuth:
https://mcp.insourcia.io/mcp- ou chave na URL:
https://mcp.insourcia.io/{votre-cle-api}
- ou chave na URL:
- OAuth:
- 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
Escolha seu método de autenticação (OAuth ou chave de API) 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
- Settings → Connectors → Add custom connector.
- Nome
Insourcia, URL MCP:https://mcp.insourcia.io/isk_VOTRE_CLECopiar - Add. A conexão é imediata, nenhuma autenticação adicional é necessária.
Claude Code
CLI
- No seu terminal:
claude mcp add insourcia --transport http --url https://mcp.insourcia.io/isk_VOTRE_CLECopiar - A conexão é imediata, nenhuma autenticação adicional é necessária.
ChatGPT
- Settings → Apps → Developer mode.
- Apps → Add app:
https://mcp.insourcia.io/isk_VOTRE_CLECopiar - Salve. A Insourcia fica disponível nas suas conversas.
Le Chat
Mistral
- Intelligence → Connecteurs → Ajouter → MCP personnalisé.
- Nome
Insourcia, URL abaixo, auth desativada:https://mcp.insourcia.io/isk_VOTRE_CLECopiar - Criar. A conexão é imediata.
HuggingChat
- + → MCP Servers → Manage MCP Servers → + Add Server.
- Nome
Insourcia, URL:https://mcp.insourcia.io/isk_VOTRE_CLECopiar - Add Server → Health Check. Ative o toggle.
Gemini CLI
CLI
- No seu terminal:
gemini mcp add insourcia --transport http --url https://mcp.insourcia.io/isk_VOTRE_CLECopiar - 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:
24 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 | Busca de empresas |
resolve_companies | Correspondência de um arquivo |
search_directors | Busca 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 |
Monitoramento legal
| Tool | Ação |
|---|---|
search_events | Busca de eventos |
get_events | Linha do tempo de uma empresa |
Processamento em lote
| Tool | Ação |
|---|---|
get_companies | Fichas em lote |
get_financials_batch | Históricos financeiros em lote |
get_credit_risks | Scores de risco em lote |
get_directors_batch | Dirigentes em lote |
get_events_batch | Eventos em lote |
get_company_graphs | Mapeamentos de grupo em lote |
Monitoramento
| Tool | Ação |
|---|---|
create_saved_search | Busca salva |
list_saved_searches | Minhas buscas salvas |
watch_company | Colocar sob monitoramento |
list_watched_companies | Minhas empresas monitoradas |
unwatch_company | Remover do monitoramento |
get_news | Feed de monitoramento |
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.
Precisa de ajuda?
Uma conexão que falha, uma tool que não responde como esperado, uma pergunta sobre cotas: escreva para [email protected]. Respondemos em até 24 horas úteis.
Informe o cliente usado (Claude, ChatGPT, Codex, n8n…) e, se tiver, o nome da tool envolvida: é isso que permite localizar a chamada nos nossos logs.