Connecter le MCP à vos services IA

Chaque serveur configuré ici est exposé comme endpoint MCP Streamable HTTP à l'adresse /api/mcp/<slug>. Le serveur Zoho CRM natif (85 outils) est sur /api/mcp/zoho. Pointez n'importe quel client compatible MCP sur cette URL.

Vos endpoints MCP

Aucun serveur pour l'instant. Créez-en un (slug zoho pour le CRM), connectez l'OAuth, puis revenez ici.

Transport : Streamable HTTP · Méthode : POST (JSON-RPC). Les serveurs déployés depuis le catalogue sont protégés par un en-tête X-MCP-Key (token affiché sur la fiche du serveur) — ajoutez-le à chaque exemple ci-dessous via -H "X-MCP-Key: <token>" ou le bloc headers: correspondant.

Claude Desktop & claude.ai (connecteurs personnalisés)

Ouvrir Réglages → Connecteurs (Settings → Connectors).
Cliquer Ajouter un connecteur personnalisé (Add custom connector).
Coller l'URL de l'endpoint et valider :

https://mcp-zoho.harmonixus.com/api/mcp/zoho

Le connecteur utilise le transport HTTP distant (remote MCP). Les outils zoho_crm_* apparaissent ensuite dans la liste des outils de la conversation.

Claude Code (CLI)

Ajouter l'endpoint comme serveur MCP HTTP :

claude mcp add --transport http zoho https://mcp-zoho.harmonixus.com/api/mcp/zoho

Vérifier avec claude mcp list. Pour un scope projet partagé, ajouter --scope project (écrit dans .mcp.json).

Eva / LibreChat

Dans librechat.yaml, déclarer le serveur sous mcpServers, puis redémarrer LibreChat :

mcpServers:
  zoho-crm:
    type: streamable-http
    url: https://mcp-zoho.harmonixus.com/api/mcp/zoho
    # En-têtes optionnels (si vous protégez l'endpoint) :
    # headers:
    #   Authorization: "Bearer ${MCP_GATEWAY_TOKEN}"

Les outils deviennent disponibles pour les agents Eva. Activez-les dans la configuration de l'agent / du point de terminaison concerné.

Client générique (n8n, scripts, autres agents)

N'importe quel client peut parler MCP en POSTant du JSON-RPC. Exemple — lister les outils disponibles :

curl -X POST https://mcp-zoho.harmonixus.com/api/mcp/zoho \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Méthodes supportées : initialize, ping, tools/list, tools/call.

Pré-requis Zoho

Créer un serveur de slug zoho en mode OAuth 2.0 (préfixe token Zoho-oauthtoken).
Sur la fiche serveur, copier le redirect URI et l'enregistrer dans la console Zoho, puis Connecter via OAuth.
Une fois connecté, les 85 outils répondent — l'access token est rafraîchi automatiquement.

→ Créer le serveur Zoho