MarginTide — Guide du serveur MCP

• robot_2Aucun humain dans la boucleVotre client MCP lit les instantanés de prix, accepte les recommandations sûres et déclenche des exécutions sans que personne n'ouvre le tableau de bord.
• tuneRespecte les plafonds du forfaitChaque appel d'outil respecte les mêmes plafonds d'unités de recherche et limites de débit que le tableau de bord. Un appel qui dépasse le plafond renvoie une erreur exploitable avec la date de réinitialisation.
• boltConception axée sur l'instantanéget_pricing_snapshot renvoie le catalogue, les prix des concurrents et la recommandation ouverte en un seul appel — 2 allers-retours pour répondre à « où sommes-nous trop chers? »

workspace_premiumNécessite le forfait Max ou Entreprise. Mettre à niveau ou consultez l'API REST pour un accès non-MCP sur n'importe quel forfait.

1. 1. Ajoutez l'URL du serveur à votre client : https://www.margintide.com/api/mcp.
2. 2. Votre client vous redirige pour vous connecter et approuver la connexion — choisissez l'espace de travail et vérifiez les permissions.
3. 3. Approuvez pour terminer. Votre client répertorie les outils immédiatement selon l'espace de travail et les permissions accordées.

Vous pouvez revoir ou déconnecter n'importe quel assistant à tout moment depuis Gérer les assistants connectés.

Les clients qui ne prennent pas en charge OAuth fonctionnent toujours avec un jeton pck_ — voir les étapes de configuration ci-dessous.

Allez dans Paramètres → Clés API et créez un nouveau jeton. Sélectionnez les portées dont votre client MCP a besoin :

Le préfixe du jeton est pck_…. Copiez-le maintenant — il n'est affiché qu'une seule fois.

Ajoutez le serveur MarginTide à la configuration de votre client. Le serveur parle le protocole MCP 2025-06-18 sur HTTP en flux continu (sans état — aucune session SSE requise).

{
  "mcpServers": {
    "price-checker": {
      "url": "https://www.margintide.com/api/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer pck_YOUR_TOKEN_HERE"
      }
    }
  }
}

{
  "mcpServers": {
    "price-checker": {
      "url": "https://www.margintide.com/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer pck_YOUR_TOKEN_HERE"
      }
    }
  }
}

Après avoir connecté votre client, appelez tools/list (ou demandez à votre client MCP de « lister les outils disponibles »). Vous devriez voir les outils que les portées de votre jeton autorisent. Si la liste est vide, vérifiez vos portées — un outil n'apparaît que lorsque votre jeton détient toutes les portées requises.

# Quick smoke-check with curl (JSON-RPC over HTTP)
curl -s -X POST https://www.margintide.com/api/mcp \
  -H "Authorization: Bearer pck_YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

• Un jeton API ou une autorisation OAuth par espace de travail : émettre un jeton, ou approuver une connexion OAuth, le limite toujours à exactement un espace de travail.
• N espaces de travail signifient N connexions MCP distinctes dans votre client — une entrée client (ou une autorisation OAuth) par espace de travail auquel vous avez besoin d'un accès simultané.
• Changer d'espace de travail signifie changer de clé : pointez votre client vers un jeton différent (ou une autorisation OAuth différente) pour vous adresser à un autre espace de travail.
• La limite de 60 requêtes par minute s'applique par clé et est partagée avec l'API REST — les appels MCP et REST effectués avec le même jeton puisent dans le même quota.

Le champ instructions du serveur (retourné lors de initialize) enseigne à votre agent comment composer les outils efficacement :

1. Appelez d’abord get_pricing_snapshot — il combine les données du catalogue, les prix des concurrents et la recommandation ouverte en un seul appel (économise 2 allers-retours ou plus par rapport à l’enchaînement d’appels de liste).
2. Examinez l’instantané, puis appelez accept_recommendation ou dismiss_recommendation seulement après avoir confirmé l’action avec l’utilisateur.
3. Après avoir appelé trigger_run, interrogez get_run_status jusqu’à ce que l’exécution atteigne un état terminal, puis lisez les résultats avec get_latest_run_results.