Brancher le serveur MCP Service4AI sur votre agent

En bref

Claude Code

Une commande dans le terminal :

claude mcp add --transport http service4ai https://mcp.service4ai.com/v1

Ajoutez --scope user pour l'avoir dans tous vos projets. Dans une session, la commande /mcp affiche l'état du serveur et ses cinq outils.

Claude (web et application de bureau)

Les serveurs MCP distants s'ajoutent comme connecteurs personnalisés, selon votre offre :

1. Ouvrez Paramètres → Connecteurs.
2. Choisissez Ajouter un connecteur personnalisé.
3. Nom : Service4AI. URL : https://mcp.service4ai.com/v1. Laissez les réglages OAuth vides.
4. Dans une conversation, activez le connecteur depuis le menu des outils.

Le connecteur est ensuite disponible sur claude.ai et dans l'application de bureau.

Cursor

Ajoutez le serveur dans ~/.cursor/mcp.json (pour tous vos projets) ou dans .cursor/mcp.json à la racine d'un projet :

{
  "mcpServers": {
    "service4ai": {
      "url": "https://mcp.service4ai.com/v1"
    }
  }
}

Le serveur apparaît ensuite dans les réglages MCP de Cursor, où vous pouvez l'activer ou le désactiver.

VS Code (GitHub Copilot)

Créez .vscode/mcp.json dans votre projet :

{
  "servers": {
    "service4ai": {
      "type": "http",
      "url": "https://mcp.service4ai.com/v1"
    }
  }
}

Les outils sont alors proposés au chat Copilot en mode agent.

ChatGPT

ChatGPT accepte les serveurs MCP distants en mode développeur, selon votre offre :

1. Activez le mode développeur dans les paramètres des connecteurs (ou applications).
2. Créez un connecteur avec l'URL https://mcp.service4ai.com/v1 et l'authentification Aucune.
3. Activez-le dans une conversation. ChatGPT peut demander confirmation avant les outils qui modifient quelque chose (louer ou annuler).

Les menus de ChatGPT changent souvent : si un intitulé diffère, cherchez « MCP » ou « connecteur » dans les paramètres.

Autres clients

Tout client qui gère le transport Streamable HTTP fonctionne avec la seule URL. Pour un client qui ne connaît que les serveurs locaux (stdio), passez par le pont mcp-remote :

{
  "mcpServers": {
    "service4ai": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.service4ai.com/v1"]
    }
  }
}

Pour explorer les outils sans agent, l'inspecteur officiel fait l'affaire : npx @modelcontextprotocol/inspector, transport « Streamable HTTP », puis l'URL du serveur.

Outils exposés

Les noms anglais (rent_human, track_mission…) sont acceptés sur les deux URL.

Tâches disponibles : queue_boulangerie, raler, tampon_cerfa, degustation, bise, place_paris, ca_depend. Le détail et les prix sont dans le catalogue.

Exemples de demandes

Une fois le serveur branché, parlez normalement à votre agent :

• « Loue un humain pour faire la queue à la boulangerie de la rue des Martyrs demain à 8 h. »
• « Combien de soupirs pour faire tamponner un Cerfa un lundi ? »
• « Est-ce que le vendredi après l'Ascension est un pont ? »
• « Envoie quelqu'un râler à ma place au service client, intensité 4. »
• « Où en est la mission que tu as lancée tout à l'heure ? »

Le serveur prévient l'agent que les humains déjeunent de 12 h à 14 h (heure de Paris) et ne travaillent pas le 1^er mai. Les agents bien élevés en tiennent compte.

Tester avec curl

Le serveur parle JSON-RPC 2.0 sur une simple requête POST, sans session à ouvrir :

curl https://mcp.service4ai.com/v1 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"estimer_soupirs","arguments":{"tache":"tampon_cerfa"}}}'

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "tache": "tampon_cerfa",
      "soupirs_estimes": 4,
      "intervalle": [3, 6],
      "confiance": "ça dépend"
    },
    "isError": false
  }
}

Remplacez tools/call par tools/list (sans params) pour obtenir la liste des outils et leurs schémas.

Dépannage

Un autre souci ? Écrivez à contact@service4ai.com. Un humain vous répondra, après son café.