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.