MarkIt

MarkIt MCP - AI をライブラリに接続

お好みの AI をお使いください。MarkIt が記憶を担います。

ヒント

手間をかけない方法（推奨）： このリポジトリの URL を AI に貼り付けて、**「MarkIt に接続して」**と伝えてください。llms.txt を読み込み、以下の手順をすべて代わりに処理します。

MarkIt は、失くしてしまいがちなリンク、投稿、メモを保存し、普段の言葉で検索できるようにします。このリポジトリは、オープンな Model Context Protocol を使って、Claude、ChatGPT、Cursor などのお好みの AI を MarkIt ライブラリに接続するための公式ガイドです。

接続すると、AI はライブラリを検索して見つけた内容を読み、新しい情報を保存したり、リマインダーを設定したりできます。キーワードではなく、ご自身の言葉で指示できます。

Server URL:  https://mark-it.co/api/mcp
Transport:   Streamable HTTP
Auth:        OAuth 2.1 (sign in) or a personal API key (mkt_...)

---

接続方法を選択

オプション 1 - サインイン（OAuth）。 キーの管理は不要です。Claude、ChatGPT web、Claude Code のみで利用できます。MarkIt はそれ以外のアプリからのサインインを拒否するため、偽アプリにだまされてサインインしてしまうことはありません。

オプション 2 - API キー。 Settings > Integrations でキーを生成します（一度だけ表示されるので、安全に保管してください）。その他すべてのアプリで利用できます。Cursor、VS Code、Codex CLI、Windsurf、Cline、Zed、スクリプト、ChatGPT デスクトップアプリが対象です。

---

オプション 1 - アプリからサインイン

アプリ	手順
Claude（claude.ai + Claude Desktop）	Settings > Connectors（Customize 内）> Add custom connector > https://mark-it.co/api/mcp を貼り付け > Connect > MarkIt にサインイン > Allow。すべてのプランで利用できます（Free ではカスタムコネクターを 1 つ利用できます）。
ChatGPT（web）	chatgpt.com/plugins > + > Add custom MCP server。アイコン： MarkIt アイコン をアップロードします（任意。プラグイン一覧でパズルのピースではなく MarkIt のロゴを表示できます）。名前： MarkIt。サーバー URL： https://mark-it.co/api/mcp。認証： OAuth。I understand and want to continue にチェック > Create as a plugin > MarkIt にサインイン > Allow。
Claude Code	claude mcp add --transport http markit https://mark-it.co/api/mcp を実行し、セッション内で /mcp を実行して Authenticate を選択します。すべてのプロジェクトで使う場合は --scope user を追加します。

その他のアプリでは、オプション 2 をお使いください。

オプション 2 - API キーを使用

1. MarkIt Settings > Integrations で Connect Your AI を開き、キーを生成します。キーは mkt_ で始まり、一度だけ表示されます。
2. clients/ からお使いのアプリの設定を取得し、mkt_your_key_here を置き換えます。

アプリ	設定
Claude Code	clients/claude-code.md
Cursor	clients/cursor.json
VS Code	clients/vscode.json
Codex CLI + ChatGPT デスクトップアプリ	clients/codex.toml（両方で ~/.codex/config.toml を共有します）
Windsurf	clients/windsurf.json
Cline	clients/cline.json
Zed	clients/zed.json
stdio のみをサポートするすべてのアプリ	clients/mcp-remote.json

キーのルール：アカウントごとに 1 つ発行し、パスワードと同じように扱ってください。チャットに貼り付けないでください。Settings からいつでも無効化または再生成できます。

AI ができること

ツール	機能
search	ライブラリを自然な言葉で検索します。カテゴリ、プラットフォーム、種類、作成者、タグ、日付で絞り込むこともできます。
fetch	ID を指定して、アイテムの保存済みコンテンツ全体を取得します。
list_categories	アイテム数とともに、カテゴリ一覧を表示します。
save_item	URL またはテキストメモをライブラリに保存します。MarkIt がスクレイピング、分類、インデックス作成を行います。保存するたびに月間の保存枠を1件消費しますが、すでに保存済みの URL を再度保存しても、何も変更されず無料です。
create_reminder	アイテムのリマインダーを設定または再スケジュールします（メールは全ユーザーが利用でき、WhatsApp／Telegram は Pro で利用できます）。
list_reminders	保留中のリマインダーを表示します。
cancel_reminder	ID を指定してリマインダーを1件キャンセルします。アイテム自体には一切触れません。Google カレンダーと同期したリマインダーは、引き続きサイト上で管理されます。
send_feedback	MarkIt の創業者に短いメッセージを直接送信します。頼まれたときに限って送信し、すべてのメッセージを実際の人間が確認します。1日あたり最大3件です。

設計上、できないこと：アイテムの削除、アカウントの編集、他のユーザーのデータへのアクセス。保存されたページのコンテンツはデータとして扱われ、指示として扱われることはありません。

プライバシーについて簡単に

AI はあなたの本人情報を使って MarkIt とやり取りし、あなたのアイテムだけを参照します。接続する AI（Claude、ChatGPT など）は、それぞれの規約に基づいて利用するあなた自身のツールです。MarkIt が独自にライブラリを外部へ送信することはありません。OAuth の許可は AI アプリから取り消すことができ、API キーは Settings から無効化できます。詳細は Privacy Policy をご覧ください。

トラブルシューティング

• キーで接続した直後に 401 が表示される：ヘッダーは Authorization: Bearer mkt_... の形式で正確に指定する必要があります。スペースが抜けていないか、キーが途中で切れていないか確認してください（Settings で再生成すると、以前のキーは無効になります）。
• Windsurf：リモートサーバーのフィールドは url ではなく serverUrl です。
• Cline："type": "streamableHttp" を明示的に設定してください。
• VS Code にサーバーを起動できないと表示される：url を含むエントリには "type": "http" も必要です。
• 承認直後に Claude が「Authorization with MarkIt failed」と表示する：一度再試行してください。再度失敗する場合は、Claude Code（オプション1）または API キーを使えるアプリ（オプション2）を使用してください。以前は Anthropic 側のバグ が原因でした。2026-10-21 に行ったテストでは、claude.ai へのサインインは再び機能していました。
• 「This app is not supported. Use an API key instead.」：サインインに対応しているのは Claude、ChatGPT web、Claude Code に限られます。API キー（オプション2）を使用してください。
• サインインウィンドウが戻ってこない：開いたブラウザータブでログインを完了してから、アプリで再試行してください。最初の認証後に再試行が必要なアプリもあります。
• mcp-remote shim：最新の状態に保ってください（mcp-remote@latest。0.1.16 より前のバージョンには、既知の重大な脆弱性があります）。Windows では、Authorization:${AUTH_HEADER} のコロンの前後にスペースを入れないでください。
• まだ解決しませんか？[email protected] までお問い合わせください。

AI のために

llms.txt をアシスタントに参照させてください。これは、接続方法やツールの効果的な使い方を説明するプレーンテキストのガイドです。同じファイルは、ブランド付き URL の mark-it.co/mcp/llms.txt からも利用できます。

Claude Code ユーザーは、さらに一歩進めることができます。 skill/ フォルダーを .claude/skills/markit/ にコピーすると、MarkIt の使い方に関するガイド（検索と保存の使い分け、メモのエチケット、リマインダーの管理など）が Claude に自動的に読み込まれます。

ライセンス

MIT。MarkIt の名称とロゴは MarkIt に帰属します。