> ## Documentation Index
> Fetch the complete documentation index at: https://help.zarms.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# AI エージェントから ZARMS を使う（MCP）

> Claude・ChatGPT・Cursor などの AI エージェントを ZARMS につなぐと、エージェントからカードの確認や作成ができます。接続方法（OAuth と API キー）の選び方、接続できる人、切断のしかた。

ZARMS は **MCP**（Model Context Protocol、AI エージェントがほかのサービスを操作するための共通の仕組み）に対応しています。Claude や ChatGPT などの AI エージェントを ZARMS につなぐと、エージェントとの会話の中で、ボードやカードを調べたり、カードを作ったり、コメントを書いたりできます。

接続先の URL は `https://app.zarms.cloud/mcp` です。

## 使える条件

* チームがトライアル中か、スターター以上のプランであること
* チームが停止・解約されていないこと
* 接続できるロールであること（下の表）

AI エージェントや API からの操作では、ZARMS のクレジットは減りません。

## 接続方法を選ぶ

| 方法 | 向いているもの | 設定する人 |
| - | - | - |
| OAuth（おすすめ） | Claude・ChatGPT など、ブラウザでログインして接続するアプリ | 使う人それぞれ |
| API キー | Cursor の設定ファイルや自作のスクリプトなど、キーを書き込むもの | キーはオーナーかマネージャーが発行 |

OAuth は、使う人が自分の Google アカウントでログインし、接続するチームと権限（読み取りだけか、書き込みもか）を選んで許可します。操作はその人の権限で行われ、あとから一覧で切断できます。

API キーは、チームに 1 つずつ発行する鍵です。キーを知っている人は誰でも使えるので、管理に注意してください。

アプリごとの手順は次の記事にあります。

* [Claude から接続する](https://help.zarms.cloud/ja/mcp/connect-claude.md)
* [ChatGPT から接続する](https://help.zarms.cloud/ja/mcp/connect-chatgpt.md)
* [Cursor から接続する](https://help.zarms.cloud/ja/mcp/connect-cursor.md)
* [API キーで接続する](https://help.zarms.cloud/ja/mcp/api-keys.md)

## OAuth で接続できる人

| ロール | OAuth での接続 |
| - | - |
| オーナー | できる |
| マネージャー | できる |
| メンバー | 管理者が **一般メンバーが MCP OAuth で接続できるようにする** をオンにしたときだけ |
| ゲスト | できない |

メンバーの接続を許可する設定は、[管理画面](https://help.zarms.cloud/ja/admin/admin-console.md) の **チーム設定** タブにあります。初めはオフです。

## 接続を確かめる・切る

| やりたいこと | 開く画面 | できる人 |
| - | - | - |
| 自分が接続したアプリを見る・切る | 右のナビの **設定** → **MCP 接続** | 接続している人 |
| メンバー全員の接続を見る・切る | 管理画面の **チーム設定** タブ → **メンバーの MCP 接続を管理** | オーナー、マネージャー |

一覧に出るのは OAuth の接続だけです。API キーを止めるときは、キーを失効させます（[API キーで接続する](https://help.zarms.cloud/ja/mcp/api-keys.md)）。

## 使えなくなるとき

次のときは、接続していても使えなくなります。

* チームのプランがベーシックになった（トライアルが終わったときを含む）
* チームが停止・解約された
* 自分のアクセスが停止された、ゲストになった、メンバーの接続許可がオフになった
* 自分か管理者が接続を切った、API キーが失効した

## エージェントからできる設定の変更

エージェントからは、カードやボードのほかに、次の設定を確認・変更できます。

| 設定 | できる人 | 範囲 |
| :- | :- | :- |
| チーム設定 | オーナー、マネージャー | チーム名、タイムゾーン、色、カードの状態の表示名、カード作成の既定値、権限や連携のスイッチ |
| 個人設定 | 接続している本人 | 通知の設定、メールでカードを登録する設定（マイボード） |

請求とプラン、紹介、通知先メール、Google ドライブの設定、AI の月間上限、チームの削除、API キーと MCP 接続の管理、メールマガジンの購読は、エージェントからは変えられません。画面から行ってください。権限のスイッチを変えるときは、エージェントに変更内容を明確に伝えてください。

## エージェントが書いたカードの説明

エージェントからカードを作ったり説明を書き換えたりすると、説明はまずカードに保存され、少しあとでカードの Google ドキュメントに書き込まれます。書き込むのは、本文がまだ空のドキュメントだけです。

エージェントがカードを読むときのドキュメントの本文は、定期的に取り込んだ写しです。直前の変更が反映されていないことがあります。

技術的な仕様（使えるツールやエンドポイント）は [ZARMS API ドキュメント](https://app.zarms.cloud/api-docs) を見てください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.