narrador

MCP et API REST

Serveur MCP et API de synthèse vocale pour agents IA

Offrez aux agents IA une API de synthèse vocale hébergée et un serveur MCP. Connectez-vous sur https://api.narrador.io/mcp avec OAuth ou une clé API, ou utilisez la référence REST dans la https://api.narrador.io/docs.

  • Documents avec narrador files

    create_files_job ou POST /v1/files/generate. Sans voiceId, la voix suit la langue du document.

  • Posts X avec narrador X

    generate_x_audio renvoie de l’audio, pas de vidéo. La vidéo s’exporte dans l’app.

  • Les mêmes crédits, MCP ou REST

    Connectez-vous avec OAuth dans Cursor, Claude Desktop ou VS Code, ou utilisez une clé nrd_files_ ou nrd_x_.

Ouvrir la documentation API

Cursor, Claude Desktop et VS Code

Configuration MCP distante — les mêmes exemples que la documentation API. Les clients compatibles OAuth MCP distant n'ont besoin que de l'URL, dont Cursor, Claude Desktop et VS Code. Les clés API restent l'alternative : nrd_files_ pour narrador files, nrd_x_ pour narrador X.

Ajoutez dans .cursor/mcp.json du projet, ou ~/.cursor/mcp.json pour tous les projets.

OAuth

Recommandé si le client prend en charge OAuth MCP distant. URL seulement — puis connexion. Scopes : narrador:files, narrador:x.

{
  "mcpServers": {
    "narrador": {
      "url": "https://api.narrador.io/mcp"
    }
  }
}

Clé API

Alternative pour clients et scripts. Même URL plus Authorization Bearer ou x-api-key.

{
  "mcpServers": {
    "narrador": {
      "url": "https://api.narrador.io/mcp",
      "headers": {
        "Authorization": "Bearer nrd_files_YOUR_SECRET_KEY"
      }
    }
  }
}

Limites

Limite de débit
60 requêtes par 60 secondes et par clé API. Au-delà, réponse HTTP 429.
Taille du fichier
Maximum 50 Mo par envoi de fichier et par téléchargement via URL sur les routes narrador files.
Texte brut
Jusqu’à 500 000 caractères dans le champ text de POST /v1/files/generate et POST /v1/files/jobs.

Questions fréquentes

Qu’est-ce qu’un serveur MCP ?
Un hôte d’outils pour un client IA. Le MCP narrador est sur https://api.narrador.io/mcp en io.narrador/narrador.
Comment l’ajouter à Claude Desktop, Cursor ou VS Code ?
Si le client supporte MCP OAuth distant, ajoutez https://api.narrador.io/mcp et connectez-vous. Sinon, utilisez Bearer avec nrd_files_ ou nrd_x_. Exemples sur https://api.narrador.io/docs.
L’API coûte-t-elle plus cher ?
Non. L’API utilise les mêmes crédits que l’app, au même tarif.