Documentazione MCP Server

Cos’è questo?

Il Model Context Protocol è uno standard aperto che consente agli assistenti AI di chiamare strumenti e leggere dati da sistemi esterni in modo sicuro. Il server MCP di Votira espone strumenti di lettura così un assistente può rispondere a domande sui tuoi sondaggi e rispondenti per tuo conto.

Autenticazione

Genera una singola chiave di accesso MCP in Impostazioni (una chiave per account). Viene mostrata solo una volta. Presentala come Bearer token sull’endpoint MCP:

Authorization: Bearer vot_mcp_xxxxxxxxxxxxxxxx

Puoi ruotare oppure elimina la chiave in qualsiasi momento; la rotazione invalida immediatamente il segreto precedente.

Configurazione client

Configura qualsiasi client MCP che supporti il trasporto HTTP streamable verso l’endpoint. Esempio di configurazione client:

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

Strumenti disponibili

Strumento	Argomenti	Restituisce
`list_surveys`	—	I tuoi sondaggi con id, titolo, stato e numero di risposte.
`get_survey`	`survey_id`	Un sondaggio con le sue domande e impostazioni.
`get_survey_responses`	`survey_id`, `limit?`, `offset?`	Risposte paginati per un sondaggio.
`get_survey_analysis`	`survey_id`	Analisi AI in cache sull’intero sondaggio e per singola domanda.

Metodi del protocollo

L’endpoint implementa i metodi principali MCP JSON‑RPC: initialize, tools/list e tools/call (più ping). Esempio di elenco strumenti:

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"}'

Esegui uno strumento

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"}}}'

Sicurezza & limiti

Gli strumenti sono in sola lettura e sempre limitati ai dati del proprietario della chiave.
Un piano account inattivo restituisce 403 Forbidden.
L’endpoint è soggetto a rate limit (600 richieste/ora per client).
Nessuna informazione personale identificabile viene scritta nei log del server.