Configuration MCP

Endpoint

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

Streamable HTTP sans état : envoyez du JSON-RPC en POST. Il n'y a pas de flux SSE, donc GET renvoie 405.

Authentification

Il y a deux façons de se connecter. Utilisez celle que votre client prend en charge.

Connexion avec votre compte (sans clé)

Ajoutez l'endpoint ci-dessus sans en-tête. Le client ouvre Fuxux dans votre navigateur, vous vous connectez et choisissez Allow access, et la connexion est établie. Rien n'est collé dans le chat.

• L'application peut utiliser les outils de cette page et rien d'autre. Elle ne voit jamais votre mot de passe et ne peut modifier ni votre offre, ni votre facturation, ni vos comptes connectés.
• Retirez une application à tout moment dans Settings, sous Connected apps. Elle cesse de fonctionner immédiatement.
• Pour les développeurs de clients : autorisation MCP standard (OAuth 2.1 avec PKCE). Les métadonnées du serveur se trouvent à /.well-known/oauth-authorization-server ; les Client ID Metadata Documents et l'enregistrement dynamique de clients sont tous deux pris en charge ; les jetons d'accès durent une heure et sont renouvelés.

Clé API

Envoyez votre clé à chaque requête :

Authorization: Bearer fx_live_your_key_here

Les clients qui peuvent définir un en-tête mais pas ajouter le préfixe Bearer peuvent envoyer x-api-key: fx_live_… à la place. Gardez vos clés dans des variables d'environnement ou dans le coffre à secrets de votre client, jamais dans des fichiers de configuration partagés.

Claude (web, ordinateur et mobile)

1. Dans Claude, ouvrez Settings, puis Connectors, et ajoutez un connecteur personnalisé.
2. Nommez-le Fuxux et collez l'endpoint : https://www.fuxux.com/api/mcp
3. Choisissez Connect, connectez-vous à Fuxux si demandé, puis choisissez Allow access.

ChatGPT

Fuxux figure dans le répertoire de plugins de ChatGPT. Ouvrez le plugin Fuxux (ou cherchez Fuxux dans Plugins), choisissez Install plugin, puis Connect Fuxux, connectez-vous et choisissez Allow access.

Ou ajoutez-le à la main comme serveur MCP personnalisé (offre ChatGPT payante requise, sur le web) :

1. Dans ChatGPT, ouvrez Plugins, choisissez Add, puis Create custom MCP server.
2. Nommez-le Fuxux, collez l'URL du serveur https://www.fuxux.com/api/mcp et laissez Authentication sur OAuth.
3. Cochez la case de confirmation, créez-le, choisissez Continue to Fuxux, connectez-vous si demandé, puis choisissez Allow access.
4. Ouvrez le plugin Fuxux et choisissez Try in chat, ou mentionnez @Fuxux dans un message.

Claude Code

Pour vous connecter avec votre compte, ajoutez le serveur sans en-tête :

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

Lancez ensuite /mcp dans Claude Code, sélectionnez fuxux et authentifiez-vous dans le navigateur.

Ou, avec une clé API, ajoutez le serveur depuis votre terminal :

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

Ou partagez-le avec un projet dans .mcp.json à la racine du dépôt (Claude Code remplace ${VAR} par la valeur de votre environnement) :

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

Cursor (en un clic)

Définissez une variable d'environnement contenant votre clé API Fuxux :

FUXUX_API_KEY=fx_live_your_key_here

Cursor remplace ${env:NAME} dans mcp.json (voir la documentation MCP de Cursor). Ajoutez ensuite le serveur :

Ou ajoutez-le à la main dans ~/.cursor/mcp.json ou dans le .cursor/mcp.json d'un projet :

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

Claude Desktop et autres clients stdio uniquement

Utilisez la passerelle mcp-remote (nécessite Node.js) dans claude_desktop_config.json. Placer l'en-tête dans env évite un problème connu avec les espaces dans les arguments sous 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 et Cue

Ajoutez Fuxux comme connecteur Custom MCP avec l'endpoint ci-dessus et un en-tête Authorization. Les valeurs pas à pas et une note de connecteur prête à l'emploi se trouvent dans le guide Cue & Manus.

Outils

• whoami — vérifie que la connexion fonctionne et lit votre e-mail et votre offre
• list_connected_accounts — vos comptes sociaux connectés, avec les ids qu'utilisent les targets de create_post
• get_dashboard — statistiques, publications à venir et comptes qui demandent votre attention
• list_posts — la file d'attente : paramètres facultatifs month, status (scheduled, published, draft, failed), limit (1–50, 20 par défaut), offset et order (upcoming, newest, recently_published, recently_updated)
• create_post — publie tout de suite, programme avec scheduled_at, ou enregistre un brouillon avec draft: true. Passez targets pour choisir les comptes ; sinon, chaque plateforme publie sur son premier compte connecté. Reddit n'est pas pris en charge.
• get_post — une publication avec ses variantes par plateforme (brouillons compris)
• update_post — reprogramme, modifie les textes ou remplace les médias d'un brouillon ou d'une publication programmée
• delete_post — supprime une publication de Fuxux (ne retire rien de ce qui est déjà publié sur la plateforme)

Ids de plateforme pour captions et targets :

twitterinstagramlinkedinfacebooktiktokyoutubeblueskythreadspinterestdiscordkicktwitchtelegramslack

La facturation, la gestion des clés API, les webhooks, les équipes et les paramètres du compte ne sont pas exposés comme outils. Les équivalents REST des outils se trouvent dans la référence de l'API.

Limites et bonnes pratiques pour l'agent

• 120 requêtes par minute par clé et 300 par minute par compte, toutes clés et applications connectées confondues. Au-delà, les outils indiquent combien de secondes attendre.
• Ne faites pas de polling. La publication aboutit en quelques minutes, donc vérifiez le statut d'une publication avec get_post au maximum une fois par minute.
• Quand une règle de la plateforme bloque une publication (par exemple, Instagram exige une image ou une vidéo), l'outil renvoie la raison sous forme d'erreur sur laquelle l'agent peut agir.

Dépannage

• "Missing or invalid Authorization" / 401: la clé a été révoquée, régénérée ou mal saisie. Créez-en une nouvelle et vérifiez le préfixe Bearer et l'espace.
• 401 après connexion avec votre compte : l'accès de l'application a expiré ou a été retiré dans Settings. Reconnectez-la.
• 401 avec une clé API : la clé est erronée ou révoquée, ou votre compte n'a pas d'offre payante. Vérifiez votre offre avant de créer une nouvelle clé. La règle de l'offre payante s'applique aux clés API, pas à la connexion avec votre compte.
• "Connect at least one account": aucune des plateformes de captions n'a de compte connecté. Quand seules certaines manquent, elles sont ignorées : comparez le résultat avec les plateformes envoyées.
• Limite de requêtes atteinte : attendez le nombre de secondes indiqué par l'outil et vérifiez que l'agent ne consulte pas le statut en boucle.