Configurazione MCP

Endpoint

https://www.fuxux.com/api/mcp

Streamable HTTP stateless: invia JSON-RPC con POST. Non c'è uno stream SSE, quindi GET restituisce 405.

Autenticazione

Ci sono due modi per collegarti. Usa quello supportato dal tuo client.

Accesso (senza chiave)

Aggiungi l'endpoint qui sopra senza header. Il client apre Fuxux nel browser, accedi e scegli Allow access, e il collegamento è fatto. Non si incolla nulla nella chat.

• L'app può usare gli strumenti di questa pagina e nient'altro. Non vede mai la tua password e non può cambiare il tuo piano, la fatturazione o gli account collegati.
• Rimuovi un'app in qualsiasi momento in Settings, sotto Connected apps. Smette subito di funzionare.
• Per chi sviluppa client: autorizzazione MCP standard (OAuth 2.1 con PKCE). I metadati del server sono in /.well-known/oauth-authorization-server; sono supportati sia i Client ID Metadata Documents sia la registrazione dinamica dei client; i token di accesso durano un'ora e vengono rinnovati.

Chiave API

Invia la tua chiave a ogni richiesta:

Authorization: Bearer fx_live_your_key_here

I client che possono impostare un header ma non aggiungere il prefisso Bearer possono inviare x-api-key: fx_live_… al suo posto. Tieni le chiavi in variabili d'ambiente o nell'archivio dei segreti del tuo client, mai in file di configurazione condivisi.

Claude (web, desktop e mobile)

1. In Claude, apri Settings, poi Connectors, e aggiungi un connettore personalizzato.
2. Chiamalo Fuxux e incolla l'endpoint: https://www.fuxux.com/api/mcp
3. Scegli Connect, accedi a Fuxux se richiesto e scegli Allow access.

ChatGPT

Fuxux è nella directory dei plugin di ChatGPT. Apri il plugin di Fuxux (o cerca Fuxux in Plugins), scegli Install plugin, poi Connect Fuxux, accedi e scegli Allow access.

Oppure aggiungilo a mano come server MCP personalizzato (serve un piano ChatGPT a pagamento, sul web):

1. In ChatGPT, apri Plugins, scegli Add, poi Create custom MCP server.
2. Chiamalo Fuxux, incolla l'URL del server https://www.fuxux.com/api/mcp e lascia Authentication su OAuth.
3. Spunta la conferma, crealo, scegli Continue to Fuxux, accedi se richiesto e scegli Allow access.
4. Apri il plugin di Fuxux e scegli Try in chat, oppure menziona @Fuxux in un messaggio.

Claude Code

Per accedere, aggiungi il server senza header:

claude mcp add --transport http fuxux https://www.fuxux.com/api/mcp

Poi esegui /mcp in Claude Code, scegli fuxux e autenticati nel browser.

Oppure, con una chiave API, aggiungi il server dal terminale:

claude mcp add --transport http fuxux https://www.fuxux.com/api/mcp --header "Authorization: Bearer $FUXUX_API_KEY"

Oppure condividilo con un progetto in .mcp.json nella root del repository (Claude Code espande ${VAR} dal tuo ambiente):

{
  "mcpServers": {
    "fuxux": {
      "type": "http",
      "url": "https://www.fuxux.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${FUXUX_API_KEY}"
      }
    }
  }
}

Cursor (in un clic)

Imposta una variabile d'ambiente con la tua chiave API di Fuxux:

FUXUX_API_KEY=fx_live_your_key_here

Cursor espande ${env:NAME} in mcp.json (vedi la documentazione MCP di Cursor). Poi aggiungi il server:

Oppure aggiungilo a mano in ~/.cursor/mcp.json o nel .cursor/mcp.json di un progetto:

{
  "mcpServers": {
    "fuxux": {
      "url": "https://www.fuxux.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:FUXUX_API_KEY}"
      }
    }
  }
}

Claude Desktop e altri client solo stdio

Usa il bridge mcp-remote (richiede Node.js) in claude_desktop_config.json. Tenere l'header in env evita un problema noto con gli spazi negli argomenti su Windows:

{
  "mcpServers": {
    "fuxux": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.fuxux.com/api/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer fx_live_your_key_here"
      }
    }
  }
}

Manus e Cue

Aggiungi Fuxux come connettore Custom MCP con l'endpoint qui sopra e un header Authorization. I valori passo per passo e una nota per il connettore già pronta sono nella guida a Cue & Manus.

Strumenti

• whoami — controlla che il collegamento funzioni e legge la tua email e il tuo piano
• list_connected_accounts — i tuoi account social collegati, con gli id usati dai target di create_post
• get_dashboard — statistiche, post in arrivo e account che richiedono attenzione
• list_posts — la coda: facoltativi month, status (scheduled, published, draft, failed), limit (1–50, predefinito 20), offset e order (upcoming, newest, recently_published, recently_updated)
• create_post — pubblica subito, programma con scheduled_at o salva una bozza con draft: true. Passa targets per scegliere gli account; altrimenti ogni piattaforma pubblica sul suo primo account collegato. Reddit non è supportato.
• get_post — un post con le sue varianti per piattaforma (bozze incluse)
• update_post — riprogramma, modifica i testi o sostituisce i media di una bozza o di un post programmato
• delete_post — elimina un post da Fuxux (non rimuove nulla di già pubblicato sulla piattaforma)

Id delle piattaforme per captions e targets:

twitterinstagramlinkedinfacebooktiktokyoutubeblueskythreadspinterestdiscordkicktwitchtelegramslack

Fatturazione, gestione delle chiavi API, webhook, team e impostazioni dell'account non sono disponibili come strumenti. Gli equivalenti REST degli strumenti sono nel riferimento API.

Limiti e buon comportamento dell'agente

• 120 richieste al minuto per chiave e 300 al minuto per account, sommando tutte le tue chiavi e le app collegate con l'accesso. Oltre il limite, gli strumenti dicono quanti secondi aspettare.
• Niente polling. La pubblicazione si conclude in pochi minuti, quindi controlla lo stato di un post con get_post al massimo una volta al minuto.
• Quando una regola della piattaforma blocca un post (per esempio, Instagram richiede un'immagine o un video), lo strumento restituisce il motivo come errore su cui l'agente può agire.

Risoluzione dei problemi

• "Missing or invalid Authorization" / 401: la chiave è stata revocata, ruotata o digitata male. Creane una nuova e controlla il prefisso Bearer e lo spazio.
• 401 dopo l'accesso: l'accesso dell'app è scaduto o è stato rimosso in Settings. Ricollegala.
• 401 con una chiave API: la chiave è sbagliata o revocata, oppure il tuo account non ha un piano a pagamento. Controlla il tuo piano prima di creare una nuova chiave. La regola del piano a pagamento vale per le chiavi API, non per l'accesso.
• "Connect at least one account": nessuna delle piattaforme in captions ha un account collegato. Quando ne mancano solo alcune, vengono saltate: confronta il risultato con le piattaforme che hai inviato.
• Limite di richieste: aspetta i secondi indicati dallo strumento e assicurati che l'agente non controlli lo stato in loop.