MCP

Collega il server MCP

Teddit ha un server MCP integrato. Collegalo a Claude, Cursor o a un altro client MCP, e la tua IA potrà leggere ogni risposta, fonte e numero del tuo spazio di lavoro, gestire prompt e concorrenti, e avviare scansioni se la chiave lo consente.

Cosa ottieni

Il server fa parte di Teddit. Non c’è nulla da installare da parte nostra né da distribuire.

Voce	Valore
Indirizzo	`https://teddit.io/mcp`
Trasporto	Streamable HTTP, senza stato: ogni richiesta sta in piedi da sola, non c’è alcuna sessione da tenere aperta.
Autenticazione	Una chiave API dello spazio di lavoro nell’header `Authorization: Bearer tdt_…`
Contenuto	30 strumenti, una risorsa (`teddit://projects`) e due modelli di prompt (`weekly_review`, `grow_prompt_set`). Sono tutti elencati nel riferimento degli strumenti.

Ogni chiamata a uno strumento riceve gli stessi controlli dell’app web. Una chiave non può mai fare più di quanto consenta il suo livello di accesso, e nulla di ciò che fa uno strumento è nascosto all’app: una scansione avviata via MCP compare nello Storico delle scansioni come qualsiasi altra.

Leggere è gratis. Uno strumento costa denaro: start_scan avvia una scansione, pagata dal credito dello spazio di lavoro. rewrite_queries non viene addebitato, ma richiede un credito superiore a zero.

Crea una chiave

Nell’app, clicca l’icona dell’ingranaggio nella barra in alto e apri la scheda API e MCP.
Premi Crea chiave. Dalle un nome che dica dove verrà usata, per esempio “Claude sul mio portatile”.
Scegli l’accesso: Lettura, Lettura + modifica o Lettura + scansione.
Copia la chiave. Inizia con tdt_ e viene mostrata una sola volta. Teddit ne conserva solo un’impronta e non può mostrarla di nuovo.

Chiunque nello spazio di lavoro può creare una chiave; cosa può fare dipende dal suo ruolo. Una chiave appartiene a un solo spazio di lavoro. Finché la finestra con la nuova chiave è aperta, gli snippet di configurazione nella pagina API e MCP sono compilati con essa, pronti da copiare.

Per mettere fuori uso una chiave, premi l’icona del cestino accanto a essa. Smette di funzionare subito. Altro sulle chiavi: Autenticazione.

Claude

Claude Code

Un solo comando aggiunge il server via HTTP:

claude mcp add --transport http teddit https://teddit.io/mcp \
  --header "Authorization: Bearer tdt_…"

Claude Desktop

Claude Desktop avvia i server MCP come programmi locali dal suo file di configurazione. Un piccolo ponte, il pacchetto open source mcp-remote, lo collega all’indirizzo di Teddit e invia la chiave. Richiede Node.js. Aggiungi questo a claude_desktop_config.json e riavvia Claude:

{
  "mcpServers": {
    "teddit": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://teddit.io/mcp", "--header", "Authorization:${TEDDIT_AUTH}"],
      "env": {
        "TEDDIT_AUTH": "Bearer tdt_…"
      }
    }
  }
}

La chiave va in TEDDIT_AUTH, dopo Bearer e uno spazio.

ChatGPT

ChatGPT aggiunge i server MCP remoti come connettori, per indirizzo. Per collegare Teddit, il connettore deve inviare la tua chiave nell’header Authorization:

Name:  Teddit
URL:   https://teddit.io/mcp
Auth:  Bearer tdt_…

Teddit accetta una chiave nell’header Authorization e nient’altro. Non ha un accesso OAuth. Un client il cui modulo per i connettori offre solo OAuth, o nessun modo di inviare un header, non può collegarsi direttamente.

Cursor e altri client

Funziona qualsiasi client che parli MCP su Streamable HTTP e possa inviare un header. Per Cursor, metti questo in .cursor/mcp.json:

{
  "mcpServers": {
    "teddit": {
      "type": "http",
      "url": "https://teddit.io/mcp",
      "headers": {
        "Authorization": "Bearer tdt_…"
      }
    }
  }
}

Per un client che configuri a mano, questi sono i tre dati di cui ha bisogno:

l’indirizzo https://teddit.io/mcp;
il trasporto: Streamable HTTP;
l’header Authorization: Bearer tdt_… su ogni richiesta.

Un client che può solo avviare programmi locali può usare il ponte mcp-remote mostrato sotto Claude Desktop.

Verifica la connessione

Chiedi alla tua IA: “Usa Teddit e dimmi a quale spazio di lavoro sei collegato.” Dovrebbe chiamare whoami e rispondere con il nome dello spazio di lavoro e il livello di accesso della chiave.

Per testare una chiave senza alcun client, chiama direttamente l’API:

curl https://teddit.io/api/whoami \
  -H "Authorization: Bearer tdt_…"

Cosa vedi	Cosa significa
HTTP 401 da `/mcp`	Non è stata inviata alcuna chiave, l’header non è nella forma `Bearer tdt_…`, oppure la chiave è stata revocata. Un accesso dal browser qui non conta; l’indirizzo MCP accetta solo chiavi.
Uno strumento risponde `Error: You do not have permission to do that.`	Il livello di accesso della chiave è troppo basso per quello strumento. Crea una chiave con più accesso.
Uno strumento risponde `Error: Project not found.`	L’id del sito è sbagliato, oppure il sito appartiene a un altro spazio di lavoro. Gli id arrivano da `list_projects`.

Cosa può fare una chiave

Accesso	Strumenti che può usare
Lettura	Tutto ciò che legge: report, tendenze, prompt e le loro risposte, concorrenti, pagine, cronologia e avanzamento delle scansioni, stime di costo, grafici.
Lettura + modifica	Quanto sopra, più: aggiungere, modificare, mettere in pausa, importare ed eliminare prompt; aggiungere, modificare e rimuovere concorrenti; cambiare le impostazioni di un sito; rileggere la sitemap.
Lettura + scansione	Quanto sopra, più: avviare e annullare scansioni, riscrivere le query importate come domande, e aggiungere un sito.

Non puoi creare una chiave con più accesso di quanto ne hai tu. Le scansioni avviate con una chiave sono pagate dallo stesso credito e contano negli stessi limiti delle scansioni avviate nell’app, e sono registrate a nome della persona che ha creato la chiave.

Prossimo passo: il riferimento degli strumenti e alcune domande di esempio.

Precedente‹ Accesso dei crawler IA SuccessivoRiferimento degli strumenti ›