clypt

@useclypt/mcp-server

Clypt 用の Model Context Protocol サーバーです。AI エージェント（Claude Desktop、Cursor、Claude Code などの MCP 対応クライアント）がポッドキャストの URL を送信すると、クリップ、任意の予告編、番組ノート、ゲスト共有リンク、トランスクリプトを受け取れます。

公開 REST API（https://useclypt.com/api/v1）をそのまま呼び出すシンプルなラッパーです。ツールは 3 つで、凝ったミドルウェアはありません。

ツール

ツール	ラップする API	戻り値
submit_job	POST /v1/jobs	{ id, status: 'queued', ... } — パイプラインを開始します。処理完了までの時間は、音声／RSS ソースで約 2～5 分、動画＋予告編で約 10～12 分です。
get_job	GET /v1/jobs/{id}	現在のジョブ状態です。status='complete' の場合、output にクリップ、任意の予告編、guest_share_url、show_notes、トランスクリプトが含まれます。failed の場合、error に code と message が含まれます。
list_jobs	GET /v1/jobs	組織の最近のジョブをカーソル方式でページ分割した一覧です。

処理は非同期です。submit_job はキューに登録された ID をすぐに返し、エージェントは処理が完了または失敗するまで get_job をポーリングします。組織に Webhook を登録すると、処理が完了または失敗するたびに job.completed と job.failed イベントが発生します。公開 API の POST /v1/webhooks から登録してください（現時点では MCP ツールはありません。今後のマイナーリリースで追加予定です）。

試してみる

Claude Desktop でサーバーを設定したら、次のように尋ねてください。

Clypt を使ってこのポッドキャストをクリップし、完了したら教えてください：https://feeds.simplecast.com/abc123

Claude は submit_job を呼び出してジョブ ID を取得し、get_job をポーリングして処理が完了または失敗するまで待ち、クリップ、予告編、トランスクリプトをインラインで表示します。処理時間は、音声／RSS で約 2～5 分、動画＋予告編で約 10～12 分です。

インストール

npm install -g @useclypt/mcp-server

インストールせずに実行することもできます。

npx -y @useclypt/mcp-server

設定

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "clypt": {
      "command": "npx",
      "args": ["-y", "@useclypt/mcp-server"],
      "env": {
        "CLYPT_API_KEY": "clk_live_..."
      }
    }
  }
}

Claude Desktop を再起動してください。その後、*「Clypt を使ってこのポッドキャストをクリップしてください：<RSS または音声 URL>」*とプロンプトを入力します。

Cursor / Claude Code / その他の MCP ホスト

同じ手順です。バイナリは mcp-server です（または、グローバルにインストールせず npx -y @useclypt/mcp-server を実行します）。必須の環境変数は CLYPT_API_KEY のみです。

サンドボックスキー（無料でテスト）

キーが clk_live_ ではなく clk_test_ で始まる場合、すべてのジョブで実際のパイプラインを実行せず、決定的なフィクスチャが返されます。文字起こし費用、R2 ストレージ費用、Stripe の請求は発生しません。実際の送信を始める前に、エージェントとの接続を確認するのに便利です。

フィクスチャの対応関係：

• source.type='video_url'（任意の URL）→ クリップ 3 件と任意の予告編を含む成功フィクスチャ
• source.type='audio_url' / rss_feed_url（URL に「fail」を含まない場合）→ 成功フィクスチャ
• 「fail」を含む URL → transcription_failed エラーフィクスチャ
• source.type='youtube_url' → youtube_ingestion_failed エラーフィクスチャ
• 不正な URL → 送信時に invalid_source_url のバリデーションエラー

useclypt.com/developers/signup で、数秒でサンドボックスキーを取得できます。クレジットカードもウェイトリストも不要です。サンドボックスキー（プレフィックス clk_test_）は決定的なフィクスチャを返すため、clk_live_ キーに切り替える前に無料でエージェントとの接続を確認できます。

環境変数

変数	必須	デフォルト	用途
CLYPT_API_KEY	はい	—	Clypt API のベアラートークンです。clk_live_* または clk_test_* を指定します。
CLYPT_BASE_URL	いいえ	https://useclypt.com	ステージングまたはローカル開発用の上書き設定です。末尾のスラッシュは取り除かれます。

開発

npm install
npm run build
npm test              # vitest unit tests with mocked fetch
npm run dev           # tsc --watch

MCP inspector CLI を使って、稼働中の API に対するスモークテストを実行します。

npm run build
CLYPT_API_KEY=clk_test_xxx \
  npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list

詳細情報

• API リファレンス：useclypt.com/developers/docs
• キーを取得：useclypt.com/developers/signup
• Clypt について：useclypt.com

ライセンス

MIT — LICENSE を参照してください。