@orbitlogistics/mcp-plain

Plain カスタマーサポートプラットフォーム用の MCP サーバー。スレッドやヘルプセンター記事などの管理ツールを Model Context Protocol 経由で提供します。

セットアップ

Claude Code を使用する場合

プロジェクトの .claude/settings.json に追加します:

{
  "mcpServers": {
    "plain": {
      "command": "npx",
      "args": ["-y", "@orbitlogistics/mcp-plain@latest"],
      "env": {
        "PLAIN_API_KEY": "${PLAIN_API_KEY}"
      }
    }
  }
}

次に、シェル環境（例: .zshrc、.envrc、またはシークレットマネージャー）で PLAIN_API_KEY を設定します。

その他の MCP クライアントを使用する場合

サーバーを直接実行します:

PLAIN_API_KEY=plainApiKey_xxx npx @orbitlogistics/mcp-plain@latest

Related MCP server: plane-mcp-server

ツール

注: このサーバーは Plain API の全機能をカバーしているわけではありません。実際に使用しているエンドポイントのみを対象としています。追加のメソッドが必要な場合は、PR を歓迎します!

スレッド

• list_threads - フィルター（ステータス、優先度、ラベル、顧客、テナント）でスレッドを一覧表示します

• get_thread - ID でスレッドの詳細を取得します（タイムラインを含む）

• get_thread_by_ref - 参照番号でスレッドを取得します（例: T-510）

• get_thread_fields - スレッドのカスタムフィールド値を取得します

• create_thread - 新しいスレッドを作成します（必要に応じてメールアドレスで顧客を自動作成します）

• reply_to_thread - 元のチャネルを通じて返信を送信します

• mark_thread_as_done - スレッドを解決済みとしてマークします

• upsert_thread_field - カスタムフィールド値を設定/更新します

• add_internal_note - 内部メモを投稿します（顧客には表示されません）

• add_labels - スレッドにカテゴリラベルを追加します

• get_label_types - 利用可能なラベルタイプを一覧表示します

スレッドリンク

• link_threads - スレッドを別の Plain スレッド、Linear の issue、Jira の issue、または汎用ソースにリンクします

• get_thread_links - スレッド上のリンクを一覧表示します

• unlink_thread - リンク ID でリンクを削除します

get_thread と get_thread_by_ref は、スレッドの最初の 25 件のリンクを links 配列でも返します。

添付ファイル

• get_attachment_download_url - 一時的なダウンロード URL を取得します

• get_attachment_content - 添付ファイルのコンテンツを取得します（テキストまたは base64）

ヘルプセンター

• list_help_centers - すべてのヘルプセンターを一覧表示します

• get_help_center - ヘルプセンターの構造を取得します（グループと記事）

• list_help_center_articles - 記事を全文付きで一覧表示します

• get_help_center_article - ID で記事を取得します

• get_help_center_article_by_slug - URL スラッグで記事を取得します

• upsert_help_center_article - 記事を作成または更新します（常に DRAFT として保存されます）

• create_help_center_article_group - 記事グループを作成します

• delete_help_center_article_group - 空の記事グループを削除します

開発

pnpm install
pnpm test
pnpm build

ライセンス

MIT