Documentation du serveur MCP

Qu’est-ce que c’est ?

Le Model Context Protocol est une norme ouverte permettant aux assistants IA d’appeler des outils et de lire des données de systèmes externes en toute sécurité. Le serveur MCP de Votira expose des outils de lecture pour qu’un assistant puisse répondre à des questions sur vos enquêtes et répondants en votre nom.

Authentification

Générez une seule clé d’accès MCP dans Paramètres (une clé par compte). Elle n’est affichée qu’une seule fois. Présentez-la comme un jeton Bearer sur le point de terminaison MCP :

Authorization: Bearer vot_mcp_xxxxxxxxxxxxxxxx

Vous pouvez faire une rotation ou supprimer la clé à tout moment ; la rotation invalide immédiatement le secret précédent.

Configuration du client

Configurez tout client MCP compatible avec le transport HTTP streamable sur ce point de terminaison. Exemple de configuration :

{
  "mcpServers": {
    "votira": {
      "url": "https://votira.co/mcp",
      "headers": { "Authorization": "Bearer vot_mcp_xxxxxxxx" }
    }
  }
}

Outils disponibles

Outil	Arguments	Renvoie
`list_surveys`	—	Vos enquêtes avec identifiant, titre, statut et nombre de réponses.
`get_survey`	`survey_id`	Une enquête avec ses questions et paramètres.
`get_survey_responses`	`survey_id`, `limit?`, `offset?`	Réponses paginées pour une enquête.
`get_survey_analysis`	`survey_id`	Analyse IA mise en cache pour l’ensemble de l’enquête et par question.

Méthodes du protocole

Le point de terminaison implémente les méthodes principales MCP JSON‑RPC : initialize, tools/list et tools/call (plus ping). Exemple de liste d’outils :

curl -X POST https://votira.co/mcp \
  -H "Authorization: Bearer $VOTIRA_MCP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Appeler un outil

curl -X POST https://votira.co/mcp \
  -H "Authorization: Bearer $VOTIRA_MCP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"get_survey","arguments":{"survey_id":"srv_123"}}}'

Sécurité & limites

Les outils sont en lecture seule et toujours limités aux données du propriétaire de la clé.
Un plan de compte inactif renvoie 403 Forbidden.
Le point de terminaison est soumis à une limite de débit (600 requêtes/heure par client).
Aucune donnée personnelle identifiable n’est enregistrée dans les journaux du serveur.