Docsie

Docsie Video-to-Docs MCP Server

AnthropicのConnectors Directory向けのリモートMCPサーバーです。Dokuta AIを使用して、動画を構造化されたドキュメントに変換します。

できること

Claudeのユーザーは、次の操作を行えます。

1. 動画URL（YouTube、Loom、Vimeo、直接リンクのMP4など）を送信する
2. ドキュメントの種類（ユーザーガイド、SOP、製品ドキュメント、ポリシー、ブログ）を選択する
3. 構造化されたMarkdownドキュメントを受け取る

無料プラン：5分以内の動画は無料で処理されます。5分を超える動画には、AIクレジット付きのDocsieアカウントが必要です。

アーキテクチャ

Claude → POST https://mcp.docsie.io/mcp (Bearer token)
              │
              ├─→ Docsie /o2/ (OAuth2 token validation)
              ├─→ Dokuta API (video analysis)
              └─→ Docsie /api/internal/mcp/ (credit deduction)

• トランスポート：ストリーマブルHTTP（MCP仕様）
• 認証：Docsieの/o2/プロバイダーを介したOAuth2認可コード＋PKCE
• ランタイム：Python 3.12＋FastMCP＋Starlette＋uvicorn

MCP ツール

ツール	説明
analyze_video	ドキュメント生成のために動画URLを送信します
check_job_status	進行状況を確認し、完了した結果を取得します
list_doc_types	利用可能なドキュメントの種類と品質ティアを一覧表示します

ローカル開発

cd mcp-server

# Install dependencies
pip install -e .

# Configure environment
cp .env.example .env
# Edit .env with your Dokuta API key and Docsie internal URL

# Run
uvicorn app.main:app --reload --port 8000

エンドポイントのテスト

# Health check
curl http://localhost:8000/health

# OAuth metadata
curl http://localhost:8000/.well-known/oauth-authorization-server

# MCP tool listing (via MCP protocol)
curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":"1","method":"tools/list","params":{}}'

環境変数

変数	説明	デフォルト
MCP_DOCSIE_BASE_URL	Docsieの公開URL（OAuthメタデータ用）	https://app.docsie.io
MCP_DOCSIE_INTERNAL_URL	Docsieの内部URL（API呼び出し用）	http://docsie-web:8080
MCP_DOKUTA_API_URL	Dokuta動画分析API	https://app.videodokuta.com/api/v1
MCP_DOKUTA_API_KEY	Dokuta APIキー	（必須）
MCP_MCP_INTERNAL_API_KEY	Django内部エンドポイント用の共有シークレット	（必須）
MCP_OAUTH2_CLIENT_ID	MCPアプリ用のOAuth2クライアントID	（必須）
MCP_FREE_TIER_MAX_SECONDS	無料で処理できる動画の最長時間（秒）	300

デプロイ（Kubernetes）

Dockerイメージは、mainへのプッシュ時にGitHub Actionsによって自動的にビルドされ、プッシュされます。

# Deploy with Helm (secrets managed via Doppler)
helm upgrade --install mcp-staging helm/docsie-mcp/ \
  -n mcp \
  --set image.tag=v2026.04.06.01 \
  --set doppler.token=$DOPPLER_SERVICE_TOKEN

Django側のセットアップ

1. Djangoの設定に内部APIキーを追加する

.envまたは環境変数に設定します。

MCP_INTERNAL_API_KEY=your-shared-secret-here

2. OAuth2アプリケーションを登録する

Django管理画面の/o2/applications/register/で登録します。

• 名前：Claude MCP Connector
• クライアント種別：Public
• 認可グラントタイプ：Authorization code
• リダイレクトURI：（ディレクトリ登録時にAnthropicから提供されます）
• 認可をスキップ：はい

3. 内部エンドポイント（設定済み）

• GET /api/internal/mcp/user-context/ — トークンの検証＋ユーザー情報
• POST /api/internal/mcp/deduct-credits/ — クレジットの差し引き

Anthropic Connectors Directoryへの申請

ディレクトリに申請するには、次の情報が必要です。

1. MCPサーバーURL：https://mcp.docsie.io/mcp
2. OAuth2メタデータURL：https://mcp.docsie.io/.well-known/oauth-authorization-server
3. 会社名：Docsie Inc.
4. 説明：「AIを使用して動画を構造化されたドキュメントに変換します。動画URLを送信すると、ユーザーガイド、SOP、製品ドキュメント、またはブログ記事を受け取れます。」
5. ロゴ：Docsieロゴ（SVG/PNG）
6. プライバシーポリシー：https://www.docsie.io/privacy-policy/
7. 利用規約：https://www.docsie.io/terms-of-service/

申請先：https://console.anthropic.com/dashboard/connectors