Serveur Ciele MCP

Accordez à un client MCP un accès contrôlé aux opérations d'administration de Ciele.

Le serveur Ciele Model Context Protocol (MCP) expose les opérations d'administration à un agent d'IA. Il dispose de deux transports, et les deux enregistrent les mêmes outils.

Le point de terminaison hébergé est POST /api/mcp sur votre déploiement. Utilisez-le pour un client qui se connecte via HTTP.
Le local server est un processus stdio que vous démarrez à partir d'une copie locale d'un dépôt.

Chaque appel d'outil parvient à l'Organisation via /api/v1, de sorte qu'une opération a un seul chemin d'exécution, quel que soit le transport qui l'a demandé.

Point de terminaison hébergé

Chaque déploiement Ciele dessert le point de terminaison à sa propre origine. Cela inclut le service hébergé, un auto-hébergement Docker et la pile locale de Ciele Desktop. Le point de terminaison ne nécessite aucune configuration.

https://ciele.example.edu/api/mcp

Authentifiez-vous avec une clé API d'organisation dans l'en-tête Authorization :

Authorization: Bearer ciele_sk_...

Une clé inconnue ou absente est refusée avec 401 avant qu'aucun outil ne soit répertorié.

The key Role is the permission boundary

The hosted endpoint has no read-only switch. Its permissions are the Role of the key: the operations layer refuses a mutation the Role does not cover with 403. A Viewer key is not a read-only agent, though. Reviewing conversations counts as curation, so a Viewer key can pin a conversation, leave feedback, and delete a conversation. Use CIELE_MCP_READ_ONLY=1 on a stdio server when you need an agent that cannot write at all.

Révisions du protocole

Le serveur prend en charge la révision 2026-07-28 et les révisions 2025. Il détermine la révision dès l'échange d'ouverture, de sorte qu'un client qui n'est pas passé à 2026-07-28 continue de fonctionner.

La révision 2026-07-28 a supprimé les sessions de protocole. Chaque requête est autonome ; par conséquent, le point de terminaison hébergé n'a besoin ni de routage persistant ni de stockage de session.

Serveur `stdio` local

Prérequis

Utilisez Node.js 22.6 ou une version ultérieure.
Clonez le dépôt Ciele.
Créez une clé API d'organisation.
Utilisez un client MCP capable de démarrer un serveur stdio local.

Lancez ce programme à partir du dépôt :

node <repo>/packages/mcp/bin/ciele-mcp.mjs

Variables d'environnement

Variable	Exigence	Objectif
`CIELE_API_KEY`	Obligatoire	Authentifie l'organisation.
`CIELE_BASE_URL`	Facultatif	Sélectionne une origine auto-hébergée.
`CIELE_MCP_READ_ONLY`	Facultatif	Refuse les actions de mutation lorsque la valeur est `1`.
`CIELE_MCP_MODERN_ONLY`	Facultatif	Refuse les clients de la révision 2025 lorsque la valeur est `1`.

La vérification en lecture seule a lieu au sein du processus MCP. Une mutation refusée n'effectue pas de requête API.

These variables apply to the local server only

A Ciele web container ignores CIELE_MCP_READ_ONLY and CIELE_MCP_MODERN_ONLY. Do not set them on a deployment and expect the hosted endpoint to obey.

Recommended first connection

Use a viewer key and set CIELE_MCP_READ_ONLY=1. Remove one restriction only when the agent must change Ciele data.

Outils disponibles

Outil	Opérations en cours
`ciele_identity`	Lire les informations relatives au déploiement, à l'organisation et aux rôles.
`manage_assistants`	Répertorier, lire, créer, mettre à jour, dupliquer ou supprimer des Assistants.
`manage_flows`	Lire le catalogue de flux, vérifier un flux sans l'enregistrer, lire les exécutions d'un flux HTTP, puis répertorier, lire, créer, mettre à jour, réorganiser ou supprimer des flux.
`manage_knowledge`	Gérez les Collections, les Sources et les FAQ.
`publish_assistant`	Lire l'état, publier, annuler la publication ou restaurer une publication.
`read_inbox`	Lister, lire, exporter, épingler, annoter, noter ou supprimer des Conversations.
`manage_improvements`	Lister, lire ou mettre à jour les améliorations.
`manage_entities`	Gérez les entités de l'organisation et les enregistrements typés.
`manage_memories`	Inspectez les paramètres et effectuez un effacement de la mémoire ciblé.
`manage_sso`	Gérez les revendications d'identité et la connexion SSO de l'organisation.
`manage_help_desks`	Gérez les centres d'assistance, les canaux, les commandes et ServiceNow.
`manage_teammates`	Gérez les collègues IA, leurs autorisations, leurs routines et leur mémoire. `provision` effectue la configuration complète en une seule action.
`manage_projects`	Gérez les Projects et le document de mémoire de chaque Project.
`manage_channels`	Lisez et façonnez les canaux des coéquipiers dont vous faites partie.
`manage_configuration`	Gérez les compétences, la sélection des compétences de l'assistant, les objectifs et les alertes.
`manage_organization`	Gérez les paramètres de l'organisation, les Members, les Invites et les API keys.
`manage_integrations`	Gérez les intégrations d'API d'assistant et les fournisseurs de modèles.

Le serveur enregistre seize outils. Chaque outil de domaine utilise un champ action pour ses opérations.

Le mode lecture seule catégorise chaque action. Il autorise les actions list, read, status, query et export tout en refusant les mutations.

Consultez Clients IA pour la configuration de chaque client pris en charge.

Vérifier la connexion

Demandez au client d'appeler ciele_identity. Confirmez l'ID de l'organisation, le rôle, la version de l'API et la liste des domaines attendus.

La suite de tests du référentiel lance également le véritable processus stdio. Elle vérifie l'initialisation, la découverte des outils et un appel d'API authentifié.