Aller au contenu
Créer mon espace

Référence technique

Serveur MCP Komi

Connectez un client MCP à Komi pour lire et gérer les données auxquelles votre compte a accès.

Streamable HTTPStatelessSDK MCP 1.31.036 outils
01

Connexion

Configurez cette URL comme serveur MCP distant dans un client prenant en charge Streamable HTTP.

Endpointhttps://api.komi-app.fr/mcp
En-têtes de connexionHTTP
Authorization: Bearer <KOMI_ACCESS_TOKEN>
Content-Type: application/json
Accept: application/json, text/event-stream

Transport sans état côté serveur. Le client MCP gère l’échange JSON-RPC et la découverte des outils.

02

Authentification

  • IdentitéJeton d’accès d’une session Komi valide.
  • RenouvellementLes sessions expirent. Le client doit fournir le nouveau jeton après renouvellement.
  • Accès anonymeRefusé avec HTTP 401.
  • Clé service_roleNe jamais l’ajouter à la configuration du client.
  • OAuth MCPNon disponible ; l’activation des clients externes est encadrée par Komi.
03

Outils disponibles

36 outils sont exposés par l’endpoint MCP. Les noms ci-dessous sont les identifiants à appeler via MCP.

Contexte et découverte8

  • get_context

    Campus, pages administrées, fuseau horaire et heure de référence.

  • search

    Recherche de campus, pages, événements, produits, tags, lieux et publications.

  • read_entity

    Lecture du contenu réel et des blocs ordonnés d’une entité.

  • list_relations

    Pages enfants, vitrines, événements, billets, publications et tags liés.

  • get_my_activity

    Billets, adhésions et participations du compte connecté.

  • discover_campus

    Découverte d’événements selon les critères fournis.

  • show_event_media

    Affichage d’une fiche événement avec ses médias officiels.

  • check_campus_availability

    Recherche de campus homonymes parmi ceux visibles par le compte.

Analyses5

  • describe_metrics

    Définitions des indicateurs disponibles.

  • analyze_activity

    Calculs d’activité sur les événements, pages et boutiques.

  • get_financial_report

    Ventes, remboursements, billets, acheteurs et scans.

  • show_live_door_dashboard

    Vue des entrées et validations de billets.

  • audit_campus

    Détection d’anomalies de calendrier et de qualité des données.

Événements et billetterie8

  • resolve_event_time

    Résolution d’une date relative dans le fuseau du campus.

  • create_event

    Création d’un événement avec lieu, billets et blocs.

  • update_event

    Modification des informations d’un événement.

  • create_ticket

    Création d’un billet ou produit.

  • update_ticket

    Modification d’un billet ou produit.

  • configure_shotgun_waves

    Configuration des vagues, quotas, horaires et accès par tags.

  • set_event_access

    Configuration de la visibilité et de l’accès d’un événement.

  • manage_venue

    Création, modification ou archivage d’un lieu.

Pages et publications7

  • describe_blocks

    Schéma et champs des blocs de contenu Komi.

  • edit_blocks

    Création, modification, déplacement ou suppression de blocs.

  • update_page

    Modification du nom ou de la description d’une page.

  • set_page_media

    Ajout d’une image de couverture ou d’un logo.

  • create_post

    Création d’une publication, en brouillon par défaut.

  • update_post

    Modification ou publication d’une publication existante.

  • publish_content

    Activation ou retrait de la découverte d’une page ou d’un événement.

Administration du campus8

  • propose_campus_blueprint

    Préparation d’une proposition de structure, sans écriture.

  • apply_campus_blueprint

    Application d’une structure de campus confirmée.

  • update_campus_settings

    Modification des paramètres du campus.

  • manage_tag

    Création, modification ou suppression d’un tag.

  • assign_user_tag

    Attribution d’un tag à une personne.

  • remove_user_tag

    Retrait d’un tag à une personne.

  • get_page_team

    Lecture de l’équipe et des permissions d’une page.

  • review_request

    Approbation ou refus d’une demande en attente.

04

Permissions et écritures

Les outils appliquent les contrôles d’accès Komi avec l’identité du compte connecté. Les droits disponibles dépendent du rôle et des accès de ce compte.

Les outils de modification peuvent créer ou modifier des données. La création d’une publication génère un brouillon par défaut ; sa publication ou son référencement requiert un appel distinct.

Demander un accès externe