Connecter un assistant

Claude et Mistral se connectent en OAuth avec la seule URL de l’espace. ChatGPT et Gemini utilisent une clé d’API Bearer.

01 Claude

Pas de clé à coller : Claude se connecte en OAuth.

1. Dans Claude : Paramètres → Connecteurs → Ajouter un connecteur personnalisé.
2. Renseignez la seule URL : https://<espace>.madata.app/mia/mcp. Nom : au choix (« Madata »).
3. Laissez l’ID client OAuth et la clé vides : l’autorisation est automatique.
4. Cliquez Connecter : une fenêtre MADATA s’ouvre. Connectez-vous à votre espace, cliquez Autoriser.
5. Claude obtient l’accès avec vos droits, révocable depuis le portail.

02 ChatGPT

Créez une Action personnalisée dans un GPT à partir du schéma OpenAPI de l’espace :

https://<espace>.madata.app/mia/mcp/openapi.json

Dans Authentication, choisissez API Key, type Bearer, et collez une clé d’API (créée dans Mon profil → Sécurité du compte → Clés API).

03 Gemini

Appelez le serveur MCP directement en JSON-RPC. Exemple Python :

import httpx

MCP_URL = "https://<espace>.madata.app/mia/mcp"
API_KEY = "mia_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

def mcp_call(method, params=None):
    resp = httpx.post(
        MCP_URL,
        json={"jsonrpc": "2.0", "id": 1, "method": method, "params": params or {}},
        headers={"Authorization": f"Bearer {API_KEY}"},
        timeout=30,
    )
    return resp.json().get("result")

tools = mcp_call("tools/list")["tools"]
kpi = mcp_call("tools/call", {"name": "get_kpi", "arguments": {"period": "month"}})

04 Mistral Le Chat

Comme Claude, en OAuth : Le Chat → Paramètres → Connecteurs → Ajouter un connecteur (MCP), puis la seule URL https://<espace>.madata.app/mia/mcp et Connecter. Si votre version demande une clé au lieu de l’OAuth, générez-en une et collez-la en Bearer.

05curl / tout langage

Le serveur est un endpoint JSON-RPC 2.0 standard. Trois appels suffisent pour démarrer : initialize, tools/list, tools/call.

BASE="https://<espace>.madata.app/mia/mcp"
AUTH="Authorization: Bearer mia_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

curl -s "$BASE" -H "$AUTH" -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"cli","version":"1"}}}'

curl -s "$BASE" -H "$AUTH" -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"list_overdue_followups","arguments":{}}}'