Server MCP

Adkumo espone un server Model Context Protocol, così qualsiasi client MCP — Claude Code, Claude Desktop, Cursor, ChatGPT — può guidare Adkumo senza lasciare la sua interfaccia di chat nativa. Cerca aziende, sfoglia annunci, elenca e crea creatività e pubblica sulle tue piattaforme pubblicitarie collegate, tutto dal tuo assistente.

Endpoint

https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp

La <project-ref> esatta del tuo workspace è nell'URL del tuo account. Se fai self-hosting, sostituisci l'host con il tuo.

Autenticazione

L'autenticazione usa OAuth 2.1 — accedi una volta con il tuo account Adkumo, il client memorizza un refresh token e la connessione resta attiva. Nessuna chiave API da generare o incollare.

La prima volta che colleghi un client, il browser si apre sull'accesso ad Adkumo. Dopo l'approvazione, il client riceve un access token a breve durata più un refresh token. Il refresh avviene automaticamente — accedi solo una volta.

Piano richiesto

Il server MCP è disponibile dal piano Starter in su. Qualsiasi account Adkumo può autenticarsi e connettersi — il client mostra il server come connesso con l'elenco completo degli strumenti — ma nel piano Free ogni chiamata a uno strumento restituisce un messaggio che invita all'upgrade invece di essere eseguita. Esegui l'upgrade su app.adkumo.com/settings/billing per sbloccare gli strumenti.

Collegare Claude Code

Un comando nel terminale:

claude mcp add adkumo \
  --transport http \
  --url https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp

Claude Code apre una scheda del browser, accedi ad Adkumo e la connessione è attiva. Verifica con claude mcp list.

Connessione da una macchina remota o SSH

OAuth apre un browser e reindirizza a un callback localhost sulla macchina che esegue il client. Se Claude Code è in esecuzione su una macchina remota o SSH mentre il browser è sul tuo laptop, quel callback non può raggiungere la CLI e l'accesso sembra bloccarsi. Due soluzioni:

Inoltra la porta di callback. Fissala con claude --callback-port 8765 ..., poi dal tuo laptop esegui ssh -L 8765:localhost:8765 <host> e completa l'accesso nel browser locale.
Incolla l'URL di callback. Se il reindirizzamento del browser fallisce dopo l'approvazione, copia l'URL di callback completo dalla barra degli indirizzi e incollalo nel prompt mostrato da Claude Code.

Collegare Claude Desktop

Modifica ~/Library/Application Support/Claude/claude_desktop_config.json (macOS — adatta il percorso su Windows / Linux):

{
  "mcpServers": {
    "adkumo": {
      "type": "http",
      "url": "https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp"
    }
  }
}

Riavvia Claude Desktop. Al primo utilizzo apre il browser per l'accesso, poi gli strumenti Adkumo compaiono nel selettore di strumenti in ogni conversazione.

Collegare Cursor

Aggiungi lo stesso server a ~/.cursor/mcp.json (o un .cursor/mcp.json a livello di progetto):

{
  "mcpServers": {
    "adkumo": {
      "url": "https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp"
    }
  }
}

Ricarica Cursor e approva l'accesso quando richiesto.

Risoluzione dei problemi

Sintomo	Causa probabile	Soluzione
401 Unauthorized a ogni chiamata	Token scaduto o revocato — sei disconnesso	Riavvia il flusso di auth: in Claude Code usa `claude mcp remove adkumo` e ri-aggiungi; negli altri client disconnetti e riconnetti.
Gli strumenti rispondono «esegui l'upgrade del piano»	Il tuo piano non include l'accesso MCP	Il server MCP richiede il piano Starter o superiore. La connessione continua a funzionare, ma gli strumenti restano bloccati finché non esegui l'upgrade su app.adkumo.com/settings/billing.
405 Method Not Allowed	Il client ha inviato `GET` / `DELETE` a `/mcp`	Il transport è stateless e solo POST — di solito una configurazione errata del client.
Gli strumenti agiscono sul brand sbagliato	È attivo un brand diverso	Chiedi al client di cambiare brand — vedi Esempi.

Una volta collegato, vedi Esempi per il catalogo completo degli strumenti e prompt da provare.