Choisir sa surface API

Insourcia expose le même socle de données par trois surfaces. Choisissez selon votre client :

Surface	URL	Idéal pour
API REST	https://api.insourcia.io/v1/companies/{siren}, etc.	Backend sur mesure, intégrations CRM, scripts
Tools RPC	POST https://api.insourcia.io/v1/rpc/tools/{name}	OpenAI Assistants, function calling, agents sans MCP, traitements par lot
MCP	https://mcp.insourcia.io/mcp	Claude, Claude Code, ChatGPT, Le Chat, Cursor, Windsurf, Continue, Cline, Gemini CLI, n8n

Que voulez-vous faire ?

« Mon backend appelle Insourcia depuis mon code »

→ API REST. Verbes HTTP standards, chemins lisibles, référence OpenAPI complète sur /docs/api-reference/.

« Un assistant ou un agent IA doit utiliser Insourcia »

→ MCP, dès que le client le prend en charge : c’est la voie la plus directe. Ajoutez https://mcp.insourcia.io/mcp comme serveur MCP ; voir le guide MCP. → Tools RPC sinon (function calling, agents sur mesure).

« J’utilise ChatGPT »

→ MCP. ChatGPT se connecte directement au serveur MCP, avec une connexion OAuth par utilisateur. Voir le guide ChatGPT.

« J’utilise n8n, Zapier ou Make »

→ MCP dans n8n (nœud client MCP). Tools RPC avec le nœud HTTP générique dans Zapier et Make, ou dans n8n si vous préférez un appel par outil. Voir n8n / Zapier / Make.

« Script ponctuel en terminal ou en CI »

→ CLI @insourcia/cli, un client en ligne de commande pour Tools RPC.

Ce qui est commun, et ce qui diffère

Toutes les surfaces s’appuient sur le même socle de données et appliquent la même authentification (clé API isk_... ou OAuth), les mêmes limites de débit, la même grille de crédits et les mêmes données réservées aux abonnés (voir Tarification et crédits). Vous pouvez les combiner sans risque.

Les écarts :

• Révélation d’email et compte : outils reveal_director_email et get_account sur le serveur MCP seulement. En REST, la révélation passe par POST /v1/companies/directors/reveal-email.
• Outils de lot (get_companies, get_financials_batch, get_credit_risks, etc.) : sur Tools RPC seulement. Sur le serveur MCP, les outils unitaires acceptent directement une liste de SIREN.
• Sections REST sans outil : certaines routes REST n’ont pas d’outil équivalent, par exemple la lecture d’un document archivé (/v1/documents/{type}/{id}) ou l’historique du score de crédit.
• Format de réponse : REST renvoie du JSON brut. Tools RPC enveloppe la réponse dans {success, data}.
• Liste des outils : Tools RPC fournit GET /v1/rpc/tools, le serveur MCP tools/list.