@paragraph-com/mcp

Paragraph 向けの MCP (Model Context Protocol) サーバー — あなたの出版物を Claude Desktop、Cursor、VS Code Copilot、および MCP 互換クライアントの AI エージェントに公開します。

リモートサーバー（推奨）

ホスト型サーバーを mcp.paragraph.com で利用します。インストールや API キーの管理は不要です。ブラウザで Paragraph アカウントを通じて認証します。

Claude Code

claude mcp add paragraph --transport http https://mcp.paragraph.com/mcp

Claude Desktop

claude_desktop_config.json に追加:

{
  "mcpServers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

Cursor

.cursor/mcp.json に追加:

{
  "mcpServers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

VS Code

.vscode/mcp.json に追加:

{
  "servers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

Related MCP server: thegraph-mcp

ローカルサーバー

サーバーをローカルで実行したい場合は、npx を使用できます。Node.js 18+ が必要です。

npx @paragraph-com/mcp

認証（ローカルのみ）

リモートサーバーは認証を自動的に処理します。ローカルで使用する場合は、環境変数で API キーを設定してください:

PARAGRAPH_API_KEY=your-key npx @paragraph-com/mcp

または、Paragraph CLI でログインします — MCP サーバーは同じ設定を共有します:

npx @paragraph-com/cli login
npx @paragraph-com/mcp

クライアント別のローカル設定

claude mcp add paragraph -- npx @paragraph-com/mcp

claude_desktop_config.json に追加:

{
  "mcpServers": {
    "paragraph": {
      "command": "npx",
      "args": ["@paragraph-com/mcp"],
      "env": {
        "PARAGRAPH_API_KEY": "your-key"
      }
    }
  }
}

.cursor/mcp.json または .vscode/mcp.json に追加:

{
  "servers": {
    "paragraph": {
      "command": "npx",
      "args": ["@paragraph-com/mcp"],
      "env": {
        "PARAGRAPH_API_KEY": "your-key"
      }
    }
  }
}

ストリーミング可能な HTTP（ローカル）

npx @paragraph-com/mcp --http --port 3100

HTTP モードは 127.0.0.1（localhost のみ）にバインドされ、POST リクエストを受け付けます。ヘルスチェックは GET /health で利用できます。

利用可能なツール

投稿

• get-post — ID またはスラッグで投稿を取得

• list-posts — 出版物または自分の投稿を一覧表示

• create-post — 新しい投稿を作成（マークダウン）

• update-post — 既存の投稿を更新

• delete-post — 投稿を削除

• send-test-email — 下書きのテストニュースレターを送信

コンテンツ

下書き用のショートフォームコンテンツ — X の投稿とスレッド、LinkedIn の投稿、単発のメール、X Articles。これらのツールは下書きのみを作成します。執筆者は Paragraph アプリから作品を送信します。

• create-content — 作品を出版物のライブラリに保存

• list-content — ライブラリを一覧表示。種類とステータスでフィルタリング可能

• get-content — 本文を含む作品を 1 件取得

• update-content — 作品の名前を変更または本文を置き換え

• archive-content — 削除せずに作品をアーカイブ

• restore-content — アーカイブした作品を復元

出版物

• get-publication — ID、スラッグ、またはドメインで出版物のメタデータを取得

購読者

• list-subscribers — 購読者を一覧表示

• get-subscriber-count — 購読者数を取得

• add-subscriber — メールまたはウォレットで購読者を追加

ユーザー

• get-user — ID またはウォレットでユーザープロフィールを取得

コイン

• get-coin — コインのメタデータを取得、または人気のコインを一覧表示

• list-coin-holders — コイン保有者を取得

検索

• search-posts — 投稿を検索

• search-blogs — 出版物を検索

• search-coins — コインを検索

フィード

• get-feed — キュレーションされたプラットフォームフィードを取得

自分

• get-me — 認証済みの出版物情報を取得

アナリティクス

• analytics-query — 出版物のアナリティクスに対して読み取り専用の SQL クエリを実行（開封率、CTR、購読者数、トップ投稿など）

• analytics-schema — アナリティクススキーマで利用可能なテーブルと列を一覧表示

ツールセットのフィルタリング

エージェントが必要とするツールのみを公開:

npx @paragraph-com/mcp --toolsets posts,search

利用可能なツールセット: posts、content、publications、subscribers、users、coins、search、feed、me、analytics、emails

例

トピックに関する投稿を検索して要約

プロンプト: 「オンチェーンガバナンスに関する投稿を検索し、上位の結果の要約を教えてください」

MCP サーバーはクエリで search-posts を呼び出します。Claude は一致する投稿を受け取り、主要なテーマ、著者、出版物の要約を生成します。

ブログ投稿の下書きと公開

プロンプト: 「新しいトークンゲーティング機能について『ウィークリーアップデート #12』というタイトルの投稿を書き、公開してください」

サーバーはタイトルと生成されたマークダウンコンテンツで create-post を呼び出し、下書きとして作成します。確認後、update-post を呼び出してステータスを published に設定し、出版物で公開します。

購読者アナリティクスの取得

プロンプト: 「私の出版物には何人の購読者がいますか？ 最新の購読者を表示してください。」

サーバーは get-me を呼び出して出版物を特定し、get-subscriber-count で合計を取得し、list-subscribers で最新の購読者とその詳細を返します。

ニュースレターのパフォーマンスに関する質問に回答

プロンプト: 「過去 30 日間の平均開封率は？ また、どの投稿が最もパフォーマンスが良かったですか？」

サーバーは post_analytics_summary に対してスコープされた SQL クエリで analytics-query を呼び出し、各投稿の開封率、CTR、ビューを返します。Claude は傾向を要約し、上位のパフォーマンスを強調します。

プラットフォームフィードの探索

プロンプト: 「今 Paragraph でトレンドは何ですか？」

サーバーは get-feed を呼び出してキュレーションされたプラットフォームフィードを取得し、Claude はトップ投稿、その著者、トピックを要約します。

投稿ライフサイクルの管理

プロンプト: 「下書きを表示して、最新の下書きにテストメールを送信してください」

サーバーは status: draft で list-posts を呼び出して下書きを取得し、最新の下書きの ID で send-test-email を呼び出して、購読者に送信する前に受信トレイでニュースレターをプレビューできるようにします。

サポート

• 問題とバグ: GitHub Issues

• メール: support@paragraph.com

• ウェブサイト: paragraph.com

リリース

npm run release patch   # 1.0.0 → 1.0.1
npm run release minor   # 1.0.0 → 1.1.0
npm run release major   # 1.0.0 → 2.0.0

ビルド、テスト、npm への公開、mcp.paragraph.com への Cloudflare Worker のデプロイ、GitHub リリースの作成を行います。スクリプトは不足している認証情報を要求します。

プライバシーポリシー

この MCP サーバーは、あなたに代わって Paragraph API に接続します。データの収集、使用、保存、およびあなたの権利の詳細については、Paragraph プライバシーポリシー を参照してください。

ライセンス

MIT