Markboard MCP サーバー

最終更新: 2026-09-06

Markboard は Markdown をそのまま扱えるカンバンボードです。このページでは、その Model Context Protocol サーバーについて説明します。AI アシスタントがあなたに代わってボードを読み書きできるようになり、計画をカードに起こす、メモをカードに添える、進行中の作業について答える、といったことが可能になります。

エンドポイント

https://markboard.work/api/mcp

トランスポートは streamable HTTP です。利用には Markboard のアカウントが必要です。markboard.work から無料で登録できます。

接続する

ボタンの下には 2 通りの接続方法があります。どちらを選ぶかは、次の 1 点で決まります。

OAuth — 対話的に使うアシスタント向け

Claude、ChatGPT、Gemini CLI など OAuth に対応した MCP クライアントで、上記のエンドポイントをコネクタとして追加してください。Markboard の画面に移動してサインインし、接続を承認します。コピーや貼り付けは不要で、キーが表示されることもありません。

Markboard は独自の OAuth 2.1 認可サーバーを備えています。Client ID Metadata Document と動的クライアント登録、PKCE (S256 のみ)、およびリソースに紐づくアクセストークンとローテーションするリフレッシュトークンに対応しています。ディスカバリーは /.well-known/oauth-authorization-server と /.well-known/oauth-protected-resource にあります。

ChatGPT の場合: https://markboard.work/api/mcp?client=chatgpt を使用してください。ChatGPT は認証エラーを他のクライアントとは異なる形式で受け取る必要があり、このパラメータがそれを選択します。サーバーもアカウントも同じものです。

API キー — ブラウザを持たないもの向け

cron ジョブ、スクリプト、ローカルのモデル、CI には「承認」をクリックする人がいないため、OAuth は使えません。設定画面で API キーを作成し、Authorization: Bearer <key> として送信してください。キーは作成時に一度だけ表示され、保存されるのはハッシュのみです。

接続がアクセスできる範囲

範囲は接続時に選びます。API キーでも選択肢は同じです。

• すべてのワークスペース (読み取りのみ) — 既定の設定です。
• ワークスペース 1 つ — 読み取りのみ、または読み書き。
• ボード 1 つ — 読み取りのみ、または読み書き。ゲストとして招待されたボードも選べます。

書き込みを許可する場合は、必ずワークスペースかボードを 1 つ指定する必要があります。「すべてに書き込む」という選択肢は意図的に用意していません。接続はあなたの権限を超えることはありません。あなたが見られないボードは接続からも見えず、後からボードに追加されても、別の範囲で作成された接続の権限が広がることはありません。

ツールでできること

ツールは 26 種類です。読み取り系のツールでは、接続中のアカウントの確認、全ボードを横断した未完了カードの一覧 (期限切れの件数つき)、ボードの一覧取得、ボードやカードの取得、カードの検索、.md や .txt の添付ファイルのテキスト読み取りができます。書き込み系のツールでは、カードの作成・移動・名前の変更、説明・期限・完了状態の設定、チェックリスト・ラベル・コメント・添付ファイルの管理、ボードやリストの作成、カードのアーカイブと復元ができます。

破壊的なツールは、設計上ひとつもありません。 アシスタントが呼び出せるもののなかに、何かを完全に削除するものはありません。アーカイブは取り消し可能で、元に戻すためのツールも用意されています。カード・ボード・ワークスペース・添付ファイルを完全に削除できるのは、アプリ上の人間だけです。

エージェントの操作は隠されません。書き込みはすべてボードのアクティビティログに記録され、操作したアプリの名前が表示されます。同じボードを開いている他の人にもリアルタイムで反映されます。

MCP のプロンプトに対応しているクライアントでは、Markboard を接続すると 4 つの定型プロンプトが表示されます。次に取り組むカードの提案、日次の進捗報告、メモからのカード作成、ボードの状況まとめの 4 つです。スラッシュコマンドやメニュー項目など、表示のされ方はクライアントによって異なります。

接続を解除する

接続済みのアプリと API キーは、アクセスできる範囲と最終利用日時とともに、すべて設定画面に一覧表示されます。接続の解除は即座に反映されます。アクセストークンとリフレッシュトークンは有効期限を待たずにその場で破棄されます。

制限

リクエストには接続ごとのレート制限があり、書き込みとファイルのアップロードにはより厳しい上限が設けられています。添付ファイルは 5 MB まで、1 枚のカードに添付できる画像は最大 5 枚です。制限を超えた場合はエラーが返ります。黙って切り詰められることはありません。

データとプライバシー

アシスタントがカードを読み取ると、そのカードの内容はアシスタントの提供者に送信され、提供者のプライバシーポリシーに従って扱われます。ツールが呼び出されない限り、Markboard の外にデータが出ることはありません。当社が保存する情報については プライバシーポリシー、および 利用規約 をご覧ください。

サポート

ご質問、不具合のご報告、セキュリティに関するご連絡は support@markboard.work までメールでお寄せください。