Agents et MCP

Le serveur MCP

eSora Sign a un serveur Model Context Protocol (MCP) à https://api.esorasign.com/mcp. Il utilise le transport Streamable HTTP avec des réponses JSON, et votre clé d'API pour l'authentification. Tout client MCP qui permet de définir un en-tête Authorization peut l'utiliser.

Chaque outil appelle l'API REST avec votre clé : un assistant peut faire exactement ce que la clé permet, et rien de plus. Les règles d'approbation s'appliquent toujours. Les assistants peuvent préparer et envoyer des documents, mais jamais signer : la signature demande toujours la personne elle-même, sur la page de signature.

Ajoutez-le à votre assistant

Claude Code :

claude mcp add --transport http esora-sign https://api.esorasign.com/mcp \
  --header "Authorization: Bearer $ESORA_API_KEY"

Clients qui utilisent un fichier de configuration JSON :

{
  "mcpServers": {
    "esora-sign": {
      "type": "http",
      "url": "https://api.esorasign.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_…" }
    }
  }
}

Créez une clé d'API distincte pour chaque assistant, pour voir son activité et pouvoir la révoquer séparément.

Outils

• list_documents (lecture) : trouve des documents par statut, étiquette ou terme de recherche. Les plus récents d'abord.
• get_document (lecture) : le statut, les destinataires et les dates d'un document.
• list_templates (lecture) : les modèles qui peuvent être envoyés, avec leurs rôles.
• create_draft_from_template (écriture) : prépare un brouillon à partir d'un modèle, avec une personne pour chaque rôle. Rien n'est envoyé.
• send_document (écriture, demande confirmation) : envoie un brouillon à ses destinataires. Les règles d'approbation s'appliquent toujours.
• send_reminder (écriture) : envoie tout de suite un rappel par courriel à un destinataire qui n'a pas signé.
• void_document (écriture, demande confirmation) : annule un document en cours de signature, avec une raison.
• verify_document (lecture) : vérifie l'empreinte SHA-256 d'un PDF auprès des dossiers scellés d'eSora Sign.

send_document et void_document sont marqués comme destructifs : les clients vous demandent avant de les exécuter. Le serveur indique aussi aux assistants de préparer d'abord des brouillons et de confirmer avant d'envoyer.

Vous pouvez aussi appeler le serveur directement en JSON-RPC :

curl -X POST "https://api.esorasign.com/mcp" \
  -H "Authorization: Bearer $ESORA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
        "params": { "name": "list_documents", "arguments": { "status": "sent", "limit": 5 } } }'