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 は追加料金ですか?
いいえ。アプリと同じクレジット、同じ価格です。