monnet

@monnet/mcp

Monnet 用の Model Context Protocol（MCP）サーバーです。

モーション、プラン、承認を MCP 対応クライアント（Claude Desktop、Cursor など）に公開するため、AI アシスタントから離れることなく、ターミナルで Monnet ワークスペースを操作できます。

インストール

MCP クライアントの設定に次の内容を追加してください（例：Claude Desktop の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）。

{
  "mcpServers": {
    "monnet": {
      "command": "npx",
      "args": ["-y", "@monnet/mcp"],
      "env": {
        "MONNET_API_KEY": "mnk_..."
      }
    }
  }
}

https://app.monnet.ai/settings の API Keys タブで API キーを生成してください。

環境変数

変数	必須	デフォルト	用途
MONNET_API_KEY	はい	—	API キー（mnk_*）。すべてのリクエストで X-API-Key ヘッダーとして送信されます
MONNET_API_URL	いいえ	https://api.monnet.ai	セルフホスト環境またはローカル開発用バックエンドの上書き

ツール

ツール	用途
monnet_whoami	接続を確認し、アカウントの API キーを一覧表示します
list_workspaces	所属するワークスペースを一覧表示します
get_inbox	受信トレイを取得します
list_motions	ワークスペース内のモーションを一覧表示します
get_motion	モーション（概要、本文、プラン、メンバー、コメント）を読み取ります
create_motion	自由形式のプロンプトから新しい下書きモーションを作成します
update_motion	モーションの概要、本文、優先度、またはプランを更新します
comment	モーションにコメントを投稿します（下記の承認ゲートを参照）
approve	プランのステップを承認します
reject	プランのステップを却下します（理由は任意）
ask_monnet	モーションについて Monnet に質問します

送信アクションの承認ゲート

あなたの本人名義でメッセージを送信するツール（例：comment）は、自動的に送信されることはありません。メッセージが MCP サーバーから送信される前に、クライアントにプレビュー付きの確認ダイアログ（MCP elicitation）が表示されます。明示的に承認しない限り、送信されません。MCP クライアントが elicitation に対応していない場合、送信は中止されます。つまり、ゲートはフェイルクローズします。

ローカル開発

npm install
npm run build

MCP クライアントがローカルビルドを使用するように設定してください。

{
  "mcpServers": {
    "monnet": {
      "command": "node",
      "args": ["/absolute/path/to/monnet-mcp/dist/index.js"],
      "env": {
        "MONNET_API_KEY": "mnk_...",
        "MONNET_API_URL": "http://localhost:8000"
      }
    }
  }
}

設定を編集した後、MCP クライアントを再起動してください。

ライセンス

MIT