Server MCP

Il server MCP ospitato di Fuxux: l'endpoint, l'accesso o la chiave API, la configurazione del client, gli strumenti e i limiti.

Fuxux gestisce un server MCP ospitato su Streamable HTTP. Collega qualsiasi client MCP e il tuo agente potrà elencare i tuoi account e post, e scrivere, programmare e pubblicare su 14 reti. La configurazione completa, client per client, è nella guida alla configurazione MCP (in inglese).

Usi Cursor, Claude Code o un altro assistente di programmazione con il server MCP di Context7? Questa documentazione è indicizzata lì: aggiungi use context7 al tuo prompt o chiedi la libreria /llmstxt/fuxux_llms_txt (Fuxux su Context7). Anche il riferimento dell'API è indicizzato, come Fuxux API.

Endpoint

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

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

Autenticazione

Accesso (OAuth)

Aggiungi l'endpoint senza header. Il client apre Fuxux nel browser, accedi e scegli Allow access. Funziona con qualsiasi piano, compreso quello gratuito. Per chi sviluppa client: OAuth 2.1 con PKCE, metadati su /.well-known/oauth-authorization-server, supporto per Client ID Metadata Documents e registrazione dinamica dei client; i token di accesso durano un'ora e vengono rinnovati.

Chiave API

Per i client senza accesso (script, alcuni agenti), invia una chiave con ogni richiesta. Le chiavi API sono incluse in tutti i piani a pagamento (Creator, Growth o Pro), senza costi aggiuntivi. Le chiavi iniziano con fx_live_ e si creano nella pagina API keys.

Authorization: Bearer fx_live_your_key_here

I client che non possono aggiungere il prefisso Bearer possono inviare x-api-key: fx_live_… al suo posto.

Configurazione rapida

Claude Code, con accesso:

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

Cursor (~/.cursor/mcp.json), con una chiave nella variabile d'ambiente FUXUX_API_KEY:

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

Strumenti

Strumento	Cosa fa
`whoami`	Controlla la connessione e restituisce la tua email e il tuo piano.
`list_connected_accounts`	I tuoi account social collegati, con gli id usati dai targets di `create_post`.
`get_dashboard`	Statistiche, prossimi post e account che richiedono attenzione.
`list_posts`	La coda, filtrata per `month`, `status` (scheduled, published, draft, failed), con `limit` (1–50), `offset` e `order`.
`create_post`	Pubblica subito, programma con `scheduled_at` o salva una bozza con `draft: true`. `targets` sceglie gli account; i testi possono essere diversi per ogni piattaforma.
`get_post`	Un post con le sue versioni e i risultati per piattaforma.
`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 dalla rete se è già stato pubblicato).

Id delle piattaforme: twitter, instagram, linkedin, facebook, tiktok, youtube, bluesky, threads, pinterest, discord, kick, twitch, telegram, slack.

Limiti

120 richieste al minuto per chiave API, e 300 al minuto per account sommando tutte le chiavi e le app collegate. Oltre il limite, gli strumenti indicano quanti secondi aspettare.
Non fare polling: la pubblicazione si conclude in pochi minuti, quindi controlla un post con get_post al massimo una volta al minuto.
Quando una regola della rete blocca un post (ad esempio Instagram richiede un'immagine o un video), lo strumento restituisce il motivo come errore.

Visualizza in Markdown (in inglese)