MCP接続手順｜ChatGPT・Claude対応

このページでは、ChatGPT、Claude、Codex、Gemini CLIなどの対応AIにHaruve MCPを接続する流れを説明します。AIによって画面の名前やボタンは異なりますが、MCP URLを登録し、OAuthで権限を許可する基本の流れは同じです。

接続情報

対応クライアント

現在、次のクライアントから接続できます。

Claudeのスマホアプリから新しい接続を追加することはできません。Geminiの通常のWeb・スマホアプリから、任意のMCPサーバーを追加する案内は現在ありません。

※ ChatGPTとCodexはOpenAI、ClaudeはAnthropic、GeminiはGoogle LLCの製品です。各社の名称・商標は各社に帰属し、Haruveは各社と提携・承認関係にありません。

1. 対応クライアントを開く

上の表にあるMCP対応クライアントを開きます。

設定の中から「MCP」「コネクタ」「外部サービス」「リモートサーバー」などの項目を探し、新しい接続を追加します。

2. MCP URLを登録する

次のURLを登録します。

https://api.haruve.jp/mcp

URLは末尾を変更せず、そのまま入力してください。

3. ログインして接続を許可する

接続を開始すると、Haruveのログイン画面が表示されます。Haruveのメールアドレスとパスワードでログインし、AIに許可する内容を確認します。

最初は「閲覧のみ」を選ぶと、AIはデータの確認や分析だけを行います。支出・収入・カテゴリ・予算・固定収支の追加、修正、削除も任せたい場合は、「変更を許可する」権限を選びます。

書き込み権限を許可する前に、クライアントが表示する操作内容と権限を確認してください。

ログイン情報は、AIとの会話欄に入力せず、Haruveのログイン画面だけに入力してください。

4. 接続を確認する

接続後、最初に次のような依頼を送ると、認証と閲覧権限をまとめて確認できます。

Haruveに接続できていますか？利用できるワークスペースを一覧表示してください。

接続できていれば、利用できる家計・会計の管理場所が表示されます。続けて次のように依頼します。

「個人用」の今月の収支サマリーを表示してください。

最初は確認や分析から試し、データの追加や削除は接続後の動作を理解してから使うことをおすすめします。

再接続・権限変更

接続には有効期限があります。しばらく使っていなかった場合や、接続が切れた場合は、AI側の再接続・更新を試してください。

閲覧だけから変更もできる状態に変える場合は、接続設定から権限を変更します。変更できない場合は、Haruveの接続を削除して、もう一度追加してください。

つながらないとき

• ログイン画面が開かない場合は、接続を削除してからもう一度追加します。
• 接続後にデータが見えない場合は、ログインしたHaruveアカウントが正しいか確認します。
• 閲覧はできるが変更できない場合は、変更の権限が許可されているか確認します。
• それでも解決しない場合は、困ったときはを参照してください。
• 詳細なエラー別の対処はトラブルシューティングを参照してください。