Choisir sa surface API

Insourcia expose les mêmes données via 3 surfaces. Choisis selon ton client :

Surface	URL	Idéal pour
REST resource	/v1/companies/{siren} etc.	Backend custom, intégrations CRM, scripts traditionnels
Tools RPC	POST /v1/rpc/tools/{name}	Custom GPT, n8n/Zapier, OpenAI Assistants, agents non-MCP
MCP	https://mcp.insourcia.io	Claude Code, Claude Desktop, Cursor, Windsurf, Continue, Cline (installation 1-clic via Smithery)

Tu veux faire quoi ?

”Mon backend appelle Insourcia depuis mon code”

→ REST resource. Verbes HTTP standards, paths intuitifs, OpenAPI complet sur /docs.

”Un agent IA doit utiliser Insourcia”

→ MCP si l’agent supporte (Claude, Cursor, Windsurf, Continue) — c’est la voie la plus directe. Pour Claude Desktop / Cursor / Windsurf : installation 1-clic via Smithery. → Tools RPC sinon (ChatGPT, GPT-4 function calling, agents custom).

”J’utilise n8n / Zapier / Make”

→ Tools RPC. Le node HTTP standard suffit, et le pattern POST /v1/rpc/tools/{name} mappe directement aux nodes “agent tool” de ces plateformes.

”Je veux créer un Custom GPT public”

→ Tools RPC + OpenAPI spec. Voir le guide Custom GPT.

”Script ad-hoc en terminal / CI”

→ CLI @insourcia/cli. C’est un wrapper sur Tools RPC.

Ce qui change selon la surface

Toutes les surfaces tapent dans la même base de données et appliquent la même authentification (clé API isk_...), le même rate-limit et le même plan-gating. Tu peux mélanger sans risque.

Différences :

• Format de réponse : REST renvoie du JSON brut. Tools RPC enveloppe dans {success, data}.
• Discovery : Tools RPC fournit un GET /v1/rpc/tools qui liste les tools disponibles avec leurs schémas.
• Versioning : REST suit /v1. Tools RPC suit le même cycle de vie.