---
title: Choisir sa surface API
description: API REST, Tools RPC ou MCP - quelle surface utiliser selon votre cas d'usage.
---

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/`](/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](/docs/guides/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](/docs/guides/custom-gpt/).

### « 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](/docs/guides/n8n-zapier/).

### « Script ponctuel en terminal ou en CI »
→ **CLI** [`@insourcia/cli`](/docs/guides/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](/docs/guides/tarification/)). 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`.