MCP & REST-API

Text-zu-Sprache-MCP-Server und API für KI-Agenten

Gib KI-Agenten eine gehostete Text-zu-Sprache-API und einen MCP-Server. Verbinde unter https://api.narrador.io/mcp mit OAuth oder einem API-Schlüssel, oder nutze die REST-Referenz unter https://api.narrador.io/docs.

  • Dokumente über narrador files

    create_files_job oder POST /v1/files/generate. Auto-Stimme nach Dokumentsprache, wenn du voiceId weglässt.

  • X-Beiträge über narrador X

    generate_x_audio liefert Audio, kein Video. Video-Export bleibt in der App.

  • Dieselben Credits, MCP oder REST

    Verbinde per OAuth in Cursor, Claude Desktop oder VS Code, oder nutze einen nrd_files_- oder nrd_x_-Schlüssel.

Cursor, Claude Desktop und VS Code

Remote-MCP-Konfiguration – dieselben Samples wie in den API-Docs. Clients mit Remote-MCP-OAuth brauchen nur die URL, inklusive Cursor, Claude Desktop und VS Code. API-Schlüssel bleiben die Alternative: nrd_files_ für narrador-files-Tools, nrd_x_ für narrador X.

In .cursor/mcp.json im Projekt oder in ~/.cursor/mcp.json für alle Projekte eintragen.

OAuth

Empfohlen, wenn der Client Remote-MCP-OAuth unterstützt. Nur URL – dann anmelden. Scopes: narrador:files, narrador:x.

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

API-Schlüssel

Alternative für Clients und Skripte. Dieselbe URL plus Authorization Bearer oder x-api-key.

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

Grenzen

Rate-Limit
60 Anfragen pro 60 Sekunden pro API-Schlüssel. Zu viel Traffic liefert HTTP 429.
Dateigröße
Maximal 50 MB pro Datei-Upload und pro URL-Download auf narrador-files-Routen.
Klartext
Bis zu 500.000 Zeichen im Textfeld bei POST /v1/files/generate und POST /v1/files/jobs.

Häufige Fragen

Was ist ein MCP-Server?
Ein Remote-Tool-Host, den ein KI-Client aufrufen kann. narradors Text-zu-Sprache-MCP-Server liegt unter https://api.narrador.io/mcp als io.narrador/narrador.
Wie füge ich es Claude Desktop, Cursor oder VS Code hinzu?
Wenn der Client Remote-MCP-OAuth unterstützt, füge https://api.narrador.io/mcp hinzu und melde dich an. Sonst nutze Authorization Bearer mit einem nrd_files_- oder nrd_x_-Schlüssel. Beispiele stehen unter https://api.narrador.io/docs.
Kostet die API extra?
Nein. Die API nutzt dieselben Credits wie die App, zum gleichen Preis.