MCP と REST API
AIエージェント向けテキスト読み上げ MCP サーバーと API
AIエージェントにホスト型のテキスト読み上げ API と MCP サーバーを。 https://api.narrador.io/mcp で OAuth か API キー、REST は https://api.narrador.io/docs。
- narrador files で文書
create_files_job または POST /v1/files/generate。voiceId を省略すると文書言語で自動選択。
- narrador X で投稿
generate_x_audio は音声を返し、動画は返しません。動画書き出しはアプリ内です。
- 同じクレジット、MCP または REST
Cursor、Claude Desktop、VS Code で OAuth、または nrd_files_ / nrd_x_ キー。
Cursor、Claude Desktop、VS Code
リモートMCP設定 — APIドキュメントと同じサンプルです。リモートMCP OAuth対応クライアントはURLだけでよく、Cursor、Claude Desktop、VS Codeを含みます。APIキーは代替です。nrd_files_ は narrador files ツール、nrd_x_ は narrador X 用です。
プロジェクトには .cursor/mcp.json を追加するか、すべてのプロジェクト用には ~/.cursor/mcp.json に追加してください。
OAuth
クライアントがリモートMCP OAuthをサポートしている場合に推奨されます。URLのみ — その後サインインします。スコープ:narrador:ファイル,narrador:x.
{
"mcpServers": {
"narrador": {
"url": "https://api.narrador.io/mcp"
}
}
}APIキー
クライアントとスクリプトの代替手段。同じURLにAuthorization Bearerまたはx-api-keyを追加。
{
"mcpServers": {
"narrador": {
"url": "https://api.narrador.io/mcp",
"headers": {
"Authorization": "Bearer nrd_files_YOUR_SECRET_KEY"
}
}
}
}制限
- レート制限
- API キーあたり 60 秒間に 60 リクエスト。超過時は HTTP 429。
- ファイルサイズ
- narrador files ルートでは、ファイルアップロードと URL ダウンロードは各 50 MB まで。
- プレーンテキスト
- POST /v1/files/generate と POST /v1/files/jobs の text フィールドは最大 500,000 文字。
よくある質問
- MCP サーバーとは?
- AI クライアントが呼べるリモートのツールホストです。narrador のテキスト読み上げ MCP は https://api.narrador.io/mcp にあり、io.narrador/narrador です。
- Claude Desktop、Cursor、VS Code への追加は?
- リモート MCP OAuth 対応なら https://api.narrador.io/mcp を追加してサインイン。そうでなければ Authorization Bearer に nrd_files_ か nrd_x_。サンプルは https://api.narrador.io/docs。
- API は追加料金ですか?
- いいえ。アプリと同じクレジット、同じ価格です。