Server MCP — Contit Docs

Contit e le sue app espongono server MCP (Model Context Protocol) remoti (Streamable HTTP): agenti come Claude, ChatGPT o Claude Code usano i dati dei tuoi workspace come tool nativi, con i tuoi permessi.

Server	Indirizzo	Cosa fa
Contit	`https://api.contit.cloud/mcp`	Workspace, tipi di contenuto e contenuti, in sola lettura
Autopilot	`https://autopilot.contit.cloud/mcp`	Contatti, liste e segmenti, campagne e invii, template, automazioni e ticket
Shop	`https://shopapi.contit.cloud/mcp`	Catalogo e traduzioni, ordini, clienti e statistiche di vendita
Site	`https://site.contit.cloud/mcp`	Pagine, paragrafi, layout, collection, asset e diagnostica dei siti

Gli indirizzi, con il tasto per copiarli, sono anche nel profilo Contit → Agenti AI.

Collegare un agente con il tuo account

È il modo consigliato: niente token da copiare. L'agente parte dall'indirizzo del server, ti fa accedere con Contit e ti chiede il consenso.

Claude

Su claude.ai o Claude Desktop: Impostazioni → Connettori → Aggiungi connettore personalizzato, incolla l'indirizzo e premi Connetti. Si apre l'accesso Contit: entra con il tuo account e premi Consenti. Il connettore funziona anche dall'app di Claude sul telefono.

ChatGPT

Su chatgpt.com aggiungi un server MCP personalizzato con l'indirizzo e autenticazione OAuth, poi accedi con Contit e consenti. Oggi i server MCP personalizzati di ChatGPT funzionano dal web.

Claude Code

bash

claude mcp add --transport http contit https://api.contit.cloud/mcp

Poi in Claude Code apri /mcp e scegli il server per accedere con Contit.

Workspace e permessi

Il collegamento vale per tutti i workspace a cui hai accesso: l'agente li elenca con il tool list_workspaces (contit_list_workspaces sul server Contit) e sceglie il workspace nella conversazione, passando workspaceId ai tool. Ogni volta il server verifica che tu abbia accesso a quel workspace. Prima di modificare qualcosa l'agente chiede conferma.

Vedere e scollegare gli agenti

Nel profilo Contit → Agenti AI trovi gli agenti collegati, con il servizio e l'ultimo uso. Scollega toglie l'accesso: l'agente lo perde entro 15 minuti e per riaverlo deve chiederti di nuovo il consenso.

Ogni server si collega a parte e chiede il suo consenso: collega solo quelli che usi.

Collegare con un Personal Access Token

Per Codex, gli script o i client configurati a mano puoi usare un Personal Access Token (PAT), inviato come Bearer.

Tipo	Dove si crea	Ambito
Per-workspace	Console → Impostazioni → Sviluppatore → Personal Access Token del workspace	un singolo workspace, con permessi per tipo di contenuto
Admin (multi-workspace)	Profilo Contit → Access Token	tutti i workspace che amministri; riservato a Owner/Manager della sottoscrizione

Il token (formato ctpat_...) viene mostrato una sola volta: copialo subito. Con un token admin usi un'unica configurazione per tutti i tuoi workspace, e l'agente sceglie il workspace come con il collegamento via account.

Per i workspace di un'app riservata che espone un proprio server MCP, il pannello mostra l'indirizzo del server MCP dell'app; per Contit usa l'endpoint /mcp delle API di Contit.

Claude Code

bash

claude mcp add --transport http contit https://api.contit.cloud/mcp \
  --header "Authorization: Bearer ctpat_xxxxxxxx"

Claude Desktop con mcp-remote

Nel file claude_desktop_config.json, con header X-Api-Key (evita problemi con lo spazio in Authorization: Bearer):

json

{
  "mcpServers": {
    "contit": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.contit.cloud/mcp",
        "--header",
        "X-Api-Key: ctpat_xxxxxxxx"
      ]
    }
  }
}

Il PAT (ctpat_…) è accettato indifferentemente come Authorization: Bearer, header X-Api-Key o query ?api_key=.

Tool del server Contit

Tool	Descrizione
`contit_list_workspaces`	Elenca i workspace accessibili
`contit_list_content_types`	Elenca i tipi di contenuto (schemi) del workspace
`contit_query_content`	Cerca i contenuti pubblicati di un tipo di contenuto, con filtri, ordinamento e paginazione
`contit_get_content`	Recupera un singolo contenuto pubblicato dato tipo di contenuto e id

Tutti i tool richiedono il permesso di lettura. Con un token per-workspace il workspace è implicito; con un token admin o con il collegamento via account i tool accettano il parametro workspaceId, e l'accesso a quel workspace è verificato a ogni chiamata.

Se il PAT ha permessi per tipo di contenuto, i tool vedono e restituiscono solo i tipi di contenuto che può leggere, come le API REST.

Validazione centralizzata per le app riservate

Le app riservate possono validare lo stesso Personal Access Token in modo centralizzato tramite l'endpoint /connect/introspect, così l'autorità che conosce i token resta unica (l'IDP). Nell'SDK .NET:

csharp

var validator = new ContitTokenValidator(appClientId, appClientSecret);
var info = await validator.ValidateAsync(incomingToken);
if (info.Active)
{
    // info.UserId, info.WorkspaceId, info.CanRead, info.CanWrite
}

Per chiamare le API a nome dell'utente con un PAT:

csharp

var client = DelegatedContitClient.FromPersonalAccessToken("ctpat_xxxxxxxx");