MCP

Connectez des agents IA à Sanad

Les agents IA créent des brouillons dans votre espace de travail. Vous validez avant tout envoi.

Point de terminaison MCP (Streamable HTTP)

https://app.sanad.cloud/mcp

Les clés API sont créées par un propriétaire d'organisation dans l'application Sanad sous Paramètres → Organisation → MCP. Cette page n'émet pas de clés.

Connecter un client

Utilisez le même point de terminaison pour Cursor, Claude, ChatGPT, Gemini ou tout client MCP en Streamable HTTP.

Cursor

Préférez OAuth lorsque c'est disponible. Collez dans ~/.cursor/mcp.json ou .cursor/mcp.json du projet. N'ajoutez pas MCP-Protocol-Version dans les en-têtes.

OAuth (recommandé)

{
  "mcpServers": {
    "sanad": {
      "url": "https://app.sanad.cloud/mcp",
      "auth": {
        "CLIENT_ID": "cursor",
        "scopes": [
          "read"
        ]
      }
    }
  }
}

Clé API

{
  "mcpServers": {
    "sanad": {
      "url": "https://app.sanad.cloud/mcp",
      "headers": {
        "Authorization": "Bearer mcp_sk_…"
      }
    }
  }
}

Claude Desktop / Claude Code

Utilisez l'identifiant OAuth statique claude, ou ajoutez le serveur HTTP via la CLI.

OAuth mcp.json

{
  "mcpServers": {
    "sanad": {
      "url": "https://app.sanad.cloud/mcp",
      "auth": {
        "CLIENT_ID": "claude",
        "scopes": [
          "read"
        ]
      }
    }
  }
}

CLI Claude Code

claude mcp add --transport http sanad https://app.sanad.cloud/mcp

ChatGPT

Ajoutez un connecteur MCP personnalisé avec authentification Bearer. Remplacez le placeholder par une clé depuis Paramètres.

ChatGPT

Name:      sanad
URL:       https://app.sanad.cloud/mcp
Auth type: Bearer token
Token:     mcp_sk_…

Gemini CLI

Utilisez httpUrl et l'en-tête Authorization. Vérifiez avec gemini mcp list.

Gemini CLI

{
  "mcpServers": {
    "sanad": {
      "httpUrl": "https://app.sanad.cloud/mcp",
      "headers": {
        "Authorization": "Bearer mcp_sk_…"
      }
    }
  }
}

Autres clients MCP

Tout client Streamable HTTP peut poster vers le point de terminaison avec Bearer ou découverte OAuth.

Autres clients MCP

Endpoint:  https://app.sanad.cloud/mcp
Transport: Streamable HTTP (POST)
Auth:      Authorization: Bearer <your key>

For AI agents reading this page

You are reading https://sanad.cloud/mcp (or /en/mcp, /fr/mcp, /ar/mcp).
Setup for Sanad MCP at https://app.sanad.cloud/mcp.
Do not invent mcp.sanad.cloud or another host.

Steps:
1. Ask which client the user uses (Cursor, Claude Desktop/Code, ChatGPT, Gemini, other) and OAuth vs API key. Do not register a server unattended.
2. Emit the matching config for that client only (do not dump every snippet unless asked). Prefer OAuth for Cursor/Claude when available; Bearer for headless/ChatGPT/Gemini.
3. Ask before OAuth consent approval. Never type credentials or complete signup for them.
4. Verify in that client's MCP UI/CLI. If not connected, stop and report the failure. Common Cursor failure: HTTP 405 if MCP-Protocol-Version was set in mcp.json headers.
5. Report the 18 tools and the draft-only / no-validate-send boundary. Ask what they want first.

Standing preference: use MCP tools over browser-driving the Sanad UI for CRM/document reads and draft writes. Prefer MCP over inventing REST calls when tools exist. Never call or invent validate/send/pay/finalize/convert/delete tools.

Tools (all 18):
get_revenue_summary, get_payment_metrics, list_customers, get_customer, list_documents, get_document, list_contracts, list_opportunities, get_opportunity, create_opportunity, update_opportunity, create_opportunities_batch, create_quote_draft, add_quote_line, update_quote_draft, create_g12_draft, fill_g12_draft, create_g12_bis_draft, fill_g12_bis_draft

Forbidden via MCP: validate/send/finalize documents, record payments, convert/delete opportunities. Humans finish validation in the Sanad UI. Money uses int64 minor units.

Reference:
- MCP endpoint: https://app.sanad.cloud/mcp
- OAuth PRM: https://app.sanad.cloud/.well-known/oauth-protected-resource
- OAuth AS metadata: https://app.sanad.cloud/.well-known/oauth-authorization-server
- API keys: Sanad app Settings → Organization → MCP (OWNER only)
- Product facts: https://sanad.cloud/llms.txt
- Support: https://sanad.cloud/en/support

Ce que les agents peuvent et ne peuvent pas faire

Autorisé

  • Lire le chiffre d'affaires, les paiements, clients, documents, contrats et opportunités
  • Créer et mettre à jour des brouillons de devis et G12 / G12 Bis
  • Créer et mettre à jour des opportunités CRM (enregistrements actifs, pas des brouillons)

Interdit via MCP

  • Valider ou envoyer des documents
  • Finaliser G12 / G12 Bis
  • Enregistrer des paiements ou poster au grand livre
  • Convertir ou supprimer des opportunités

Pas sûr du forfait ?

Demandez une courte démo. Nous regardons comment vous facturez aujourd'hui, montrons Sanad sur votre flux, et répondons aux questions de tarif. En général sous un jour ouvré.

Préférences de cookies

Nous utilisons des cookies pour améliorer votre expérience et (optionnellement) activer les analyses.