Serveur MCP

Kreatoai expose un serveur MCP (Model Context Protocol) : le standard qui permet à un assistant IA d'utiliser des outils externes. Une fois connecté, vous pouvez dire à Claude ou Cursor « publie cette vidéo sur mes deux comptes TikTok jeudi à 18 h en brouillon » ou « crée une image pour annoncer notre soirée de vendredi », et l'assistant appelle Kreatoai pour vous.

Principe

Le serveur est hébergé : rien à installer, il suffit de donner l'URL https://api.kreatoai.com/mcp et une clé API à votre client. Chaque outil rejoue un appel de l'API /v1 avec cette clé : mêmes règles, mêmes quotas, mêmes permissions que l'API — le MCP n'a aucun privilège particulier.

Deux adresses existent. https://api.kreatoai.com/mcp expose tous les outils, création d'images comprise. https://api.kreatoai.com/mcp/social publie, programme et héberge des médias, sans génération : c'est celle du connecteur Claude décrit sur kreatoai.com/claude, pour l'annuaire des connecteurs d'Anthropic, qui n'accepte pas la génération.

Connexion en un clic (OAuth)

Les clients qui gèrent l'authentification OAuth n'ont pas besoin de clé : donnez-leur seulement l'URL https://api.kreatoai.com/mcp, ils vous renvoient sur une page Kreatoai où vous choisissez les permissions, puis la connexion est établie. Elle apparaît dans Réglages → Claude et API → Applications reliées, d'où vous la déconnectez d'un geste. Le jeton d'accès expire au bout d'une heure et se renouvelle tout seul ; si le renouvellement est refusé — connexion fermée de votre côté, jeton réutilisé par un tiers — l'application vous redemande l'autorisation.

Standard implémenté : OAuth 2.1 avec PKCE (S256), enregistrement dynamique du client (RFC 7591), découverte via /.well-known/oauth-authorization-server et /.well-known/oauth-protected-resource. Les sections suivantes décrivent l'alternative par clé API, utile pour les automatisations sans navigateur (n8n, scripts).

Claude Code

claude mcp add --transport http kreatoai https://api.kreatoai.com/mcp \
  --header "Authorization: Bearer sk-kre-v1-votre_cle"

Puis, dans une session : « Liste mes comptes connectés » ou « Programme ce texte sur LinkedIn demain à 9 h ». Vérifiez la connexion avec /mcp.

Claude Desktop

Claude Desktop se connecte aux serveurs distants via le pont mcp-remote. Ajoutez ceci à votre claude_desktop_config.json :

{
  "mcpServers": {
    "kreatoai": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.kreatoai.com/mcp",
        "--header", "Authorization: Bearer sk-kre-v1-votre_cle"
      ]
    }
  }
}

Cursor

Dans .cursor/mcp.json (projet) ou ~/.cursor/mcp.json (global) :

{
  "mcpServers": {
    "kreatoai": {
      "url": "https://api.kreatoai.com/mcp",
      "headers": { "Authorization": "Bearer sk-kre-v1-votre_cle" }
    }
  }
}

n8n et autres clients

Tout client compatible Streamable HTTP fonctionne : nœud « MCP Client » de n8n (transport HTTP Streamable, en-tête Authorization), Devin Desktop, Zed, VS Code, le MCP Inspector… La clé peut aussi être passée via l'en-tête x-api-key.

Outils disponibles

Exemple de conversation complète : « Fais-moi une image verticale d'un plat qui sort du four, puis publie-la sur Instagram et Facebook avec la légende “Trois dîners prêts en 10 minutes” ». L'assistant enchaîne get_workspace (solde) → create_generation → get_generation (jusqu'à completed) → create_post.

Permissions et sécurité

Les scopes de la clé sont les permissions de l'assistant. Un outil dont la clé n'a pas le scope n'est pas exposé du tout : une clé accounts:read ne peut pas publier. Créez une clé dédiée par assistant, avec le minimum nécessaire, et une durée de vie courte.

Les actions qui coûtent (création d'image) ou publient sont marquées comme telles auprès de l'assistant, qui vous demande normalement confirmation avant de les exécuter. Les erreurs renvoyées expliquent quoi faire (compte non connecté, quota atteint…) pour que l'assistant puisse vous guider sans consulter cette documentation.