メインコンテンツにスキップ

Rimo MCP 手順書

コーディングツールで使う

このページでは、お使いのパソコン上で動作するコーディングツール(Claude Code・Codex CLI・Cursor・Claude Desktop)に、Rimoを接続する方法を説明します。これらのツールは、rimo バイナリに同梱されたローカルMCP サーバー(rimo mcp)を通じてRimoと通信します。

連携を設定すると、各ツールからRimoノートの一覧表示、トランスクリプトの取得、検索、質問応答が行えるようになります。

  • Claudeをお使いの場合は、こちらをご確認ください。

  • ChatGPTをお使いの場合は、こちらをご確認ください。

  • Microsoft Copilotをお使いの場合は、こちらをご確認ください。

1. 必要条件

  1. rimo がインストールされ、$PATH 上にあること
    rimo version で確認できます。未インストールの場合は、「Rimo CLI」のインストールを参照してください。

  2. ログイン済みのアカウント
    rimo auth login を実行してブラウザで認証してください。 トークンは OS の認証情報ストアに保存されます。MCPサーバーはCLIと同じ認証情報を 再利用するため、MCP専用のログインは不要です。

Claude Desktop は例外です:ワンクリック拡張機能に rimo が同梱されているため、そのパスでは CLIのインストールも rimo auth login のセッションも不要です。下記の Claude Desktop(ワンクリック拡張機能) を参照してください。

2. クライアント別のセットアップ

2.1 Claude Code

.mcp.jsonrimo エントリを追加します。プロジェクトローカル(./.mcp.json、リポジトリと一緒にコミット)または、ユーザーグローバル(~/.claude/mcp.json)のどちらでも動作します。

{
"mcpServers": {
"rimo": {
"type": "stdio",
"command": "rimo",
"args": ["mcp"]
}
}
}

Claude Codeを再起動すると、新しいサーバーが起動します。Rimoのツールがツールピッカーに表示されるので、自然言語で問いかけるだけで Claude Codeが適切なツールにルーティングします。

2.2 Claude Desktop(ワンクリック拡張機能)

Claude DesktopはMCP サーバーを拡張機能.mcpb バンドル)として導入します。claude_desktop_config.json を手で編集する必要はありません。Rimo のバンドルは自己完結型で、rimo CLI のインストールは不要です。

  1. バンドルを入手する:最新リリースから rimo.mcpb をダウンロードします(macOS・Windows 対応)。

  2. インストールする:Claude Desktopの「設定」>「 Extensions」を開き、rimo.mcpb をウィンドウにドラッグ&ドロップします(または Install from file を使用)。ファイルをダブルクリックしても導入できます。

  3. サインインする:Rimoでパーソナル API キーを作成し、拡張機能のRimo API key設定に貼り付けます。Claude Desktopがキーを安全に保存します。

    • すでに rimo CLIを使っている場合は、キーを空欄のままにすれば rimo auth login のセッションが再利用されます。

  4. 有効化する:RimoのツールがClaude Desktopのツール一覧に表示されます。自然言語で問いかければ、Claudeが適切なツールにルーティングします。

2.3 Codex

Codex CLI は .mcp.json を読み込みません。MCP サーバーは ~/.codex/config.toml[mcp_servers.<name>](TOML)に登録します。rimo エントリを追加してください。

[mcp_servers.rimo]
command = "rimo"
args = ["mcp"]

追加したらCodexを再起動して新しいサーバーを起動させます。Rimoのツールが利用可能になり、自然言語で問いかければCodexが適切なツールにルーティングします。Codexが引き継ぐ PATHrimo が含まれていない場合は、command に絶対パスを指定してください(例: command = "/usr/local/bin/rimo")。

2.4 Cursor

Cursorの「設定」>「MCP」 >「Add new MCP server」で以下を入力します。

  • Type: Command (stdio)

  • Command: rimo

  • Args: mcp

保存してCursorのMCPパネルをリロードすると、Rimoのツールが表示されます。

2.5 その他のMCPクライアント

stdio JSON-RPCを扱える任意のMCPクライアントで動作します。

起動コマンドは以下のとおりです。

rimo mcp

クライアントは、stdoutからJSON-RPCを読み取り、stdinに書き込みます。ログ出力はstderrに流れるため、プロトコルストリームと衝突することはありません。

3. 利用可能なツール

3.1 ツール一覧

ツール名

役割

note_list

自分のノートを一覧表示

page_size / page_token でページネーション可能

note_list_attended

参加者として出席したノートの一覧

note_get

IDで1件のノートを取得

既定はメタ情報のみ。meta=false で全文を取得

note_read

ノートの内容をテキスト/マークダウンで読む(format=document/transcript/full/meeting_chat/document_by_id

note_list_participants

ノートの参加者一覧(トランスクリプトの speaker_uuid と結合可能)

note_list_documents

ノートに添付されたドキュメントの一覧

note_get_document

ノートからIDで1件のドキュメントを取得

note_get_meeting_chat

ノートのミーティングチャットログを取得

note_search

ノート全体に対するキーワード検索

note_semantic_search

概念/意味ベースの検索(ランク付けされたノートを返す。AI による回答なし)

note_ask

自然言語クエリ

AI による合成回答とソースノートを返します

team_list

組織内のチームを一覧表示

page_size / page_token でページネーション可能

rimo_auth_status

設定済みアカウントの一覧(rimo auth status と同じ形式)

3.2 用途別の検索ツールの選び方

  • note_search — 厳密なキーワードでの検索。最も軽量。

  • note_semantic_search — 「料金戦略に関するノート」のような概念での検索。ランク付けされたノートが返るが AI 回答は含まれません。

  • note_ask — 質問して合成回答を得る。LLM を呼び出すため、用途に応じて使い分けてください。

4. エージェントへの問いかけ例

rimo mcp を組み込んだあとは、エージェントが自然言語の入力から適切なツールを選択します。

問いかけ

エージェントが選ぶツール

「今週のRimoノートを見せて。」

note_list

「前回のスプリントで出席したRimoミーティングは?」

note_list_attended

「ノート <id> のトランスクリプトを取得して。」

note_get

「ミーティング <id> の参加者は誰?」

note_list_participants

「ノート <id> に添付されているドキュメントは?」

note_list_documents

「ノート <id> からドキュメント <doc> を取得して。」

note_get_document

「Rimoノートで『料金戦略』に言及しているものを探して。」

note_search

「オンボーディングに関するノート — その表現を使っていなくても。」

note_semantic_search

「Q3リリースについて何を決めた?」

note_ask

「現在ログインしている Rimo アカウントは?」

rimo_auth_status

「ノート id のトランスクリプトとドキュメントを、読みやすいテキスト形式で表示して。」

note_read

5. 予約済みツール引数

すべてのRimo APIツールは、各操作固有のパラメータに加えて、以下の引数を受け付けます。CLIのグローバルフラグと対応しています。

引数

効果

account

string

特定の設定済みアカウントを使用
--account と同じ)

fields

string

残すレスポンスフィールドのカンマ区切りホワイトリスト
--fields と同じ)

excludes

string

除外するレスポンスフィールドのカンマ区切りリスト
--excludes と同じ)

dry_run

boolean

副作用なしでシミュレーションする
--dry-run と同じ)

こちらの回答で解決しましたか?