Memlane

@memlane/mcp

保存したリンクやメモを保管する個人用ライブラリ、Memlaneを、ローカル MCP サーバーに対応した AI アシスタントに接続します。

前提条件

1. Memlane アカウント
2. アプリの 管理 → 接続 → API キー から取得した API キー
3. Node.js 18 以降（npx 用）

設定

このサーバーは stdio 経由でローカル実行されます。互換性のあるホストのほとんどが、同じ JSON 形式を使用します。

{
  "mcpServers": {
    "memlane": {
      "command": "npx",
      "args": ["-y", "@memlane/mcp"],
      "env": {
        "MEMLANE_API_KEY": "ml_live_…"
      }
    }
  }
}

変数	必須	デフォルト
MEMLANE_API_KEY	はい	なし
MEMLANE_API_URL	いいえ	https://api.memlane.io

npm install -g @memlane/mcp の実行後は、npx の代わりに "command": "memlane-mcp" を使用できます。

対応ホスト

ホスト	設定の追加場所
Cursor	設定 → MCP、またはプロジェクト内の .cursor/mcp.json
Claude Code	claude mcp add memlane -- npx -y @memlane/mcp（-e MEMLANE_API_KEY=… を渡します）
Windsurf	~/.codeium/windsurf/mcp_config.json
VS Code + Copilot	.vscode/mcp.json — 以下を参照してください
Gemini CLI	~/.gemini/settings.json

ChatGPT と Claude Desktop では、代わりにリモート MCP エンドポイントを使用してください（OAuth を使用し、API キーは不要です）。

設定ファイルを編集した後は、ホストアプリを再起動してください。

VS Code

VS Code では、ルートキーとして "mcpServers" ではなく "servers" を使用します。

{
  "servers": {
    "memlane": {
      "command": "npx",
      "args": ["-y", "@memlane/mcp"],
      "env": {
        "MEMLANE_API_KEY": "ml_live_…"
      }
    }
  }
}

VS Code の設定で MCP を有効にします："chat.mcp.enabled": true。

ChatGPT とリモート MCP ホスト

ChatGPT、Claude Desktop、ウェブ版 Claude、その他のリモート MCP クライアントでは npx を実行できません。代わりに、Memlane のホスト型エンドポイントを使用してください。

URL： https://api.memlane.io/mcp

1. AI アプリで、この URL を指定してカスタム MCP コネクターを追加します。
2. OAuth のサインインフローを完了します（Memlane アカウント：マジックリンク、または今後追加予定のソーシャルプロバイダー）。
3. 同意画面でアクセスを承認します。

API キーは不要です。接続を解除するには、AI アプリの設定からコネクターを削除します。

ツール

ローカルサーバーは 10 個の MCP ツールを公開します。関数の詳細なリファレンス：

• docs/TOOLS.md — 各ツールの機能、パラメーター、戻り値の形式、ワークフローのヒント
• docs/API.md — REST の対応関係、認証スコープ、curl の例

ツール	説明
search_saves	ライブラリを意味検索します
list_saves	フィルター（プロジェクト、トピック、種類、ステータス）を使って保存項目を参照します
get_save	メタデータを取得します。Markdown 本文全体の取得は任意です
capture_url	URL を保存します（エンリッチメントはバックグラウンドで実行されます）
create_note / update_note	Markdown メモを作成または編集します
list_projects / list_topics	プロジェクトとトピックを一覧表示します
add_topic_to_save / remove_topic_from_save	保存項目にトピックをタグ付け、またはタグを解除します

セキュリティ

API キーは秘密情報です。MCP ホストの環境設定に保存してください。バージョン管理にコミットしないでください。キーが漏えいした場合は、管理 → 接続 → API キー でそのキーを無効化してください。

ライセンス

MIT