MCP 経由で Zenkit を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Zenkit をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Zenkit + Gemini

AI を Zenkit で働かせます。ワークスペースとコレクションを確認し、フィールド、エントリー、メンバー、アクティビティを読み取り、全体を検索できます。あなたの確認後には、エントリーの作成や更新、コメントの投稿も行えます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

ZENKIT_API_KEY

ステップ 1 — 認証情報を取得

セットアップは約 2 分で、必要なのは Zenkit アカウントだけです。

1. Zenkit でアバターをクリックしてプロフィールを開き、Integrations に進みます。
2. API Key で新しいキーを生成し、コピーします。
3. キーだけを、スペースやヘッダー名を付けずに ZENKIT_API_KEY に貼り付けます。
4. コネクターをインストールし、zenkit_get_current_user を実行します。キーが属するユーザーが表示されます。

キーはあなたとして動作します: あなたが Zenkit で開けるものはすべて、どのワークスペースでも開けます。新しいキーを生成すると古いキーは無効になり、新しいキーを貼り付けるまでコネクターは動きません。AI に一部のワークスペースだけを見せたい場合は、そのワークスペースにだけ参加している別の Zenkit ユーザーを使ってください。

すべての Zenkit アプリに 1 つの API: Zenkit Base、Zenkit To Do、Zenkit Projects、Hypernotes は同じデータを共有しているため、同じキーで ToDo リスト、プロジェクトボード、データベースにアクセスできます。

Zenkit の構成: ワークスペースにはコレクション（API ではリストと呼びます）があり、コレクションにはフィールドとエントリーがあります。ビューによって、エントリーはタスク、カード、行、ノートとして表示されます。AI はまず zenkit_list_workspaces_with_lists を使い、zenkit_list_fields でコレクションのフィールドを読み取ってから、エントリーを 50 件ずつ読み進めるか、開けるものすべてを対象にテキスト検索します。

読み取れるデータ: ワークスペースとそのメンバー、コレクションとアクセスできるユーザー、型とラベルの選択肢を含むフィールド、すべてのフィールド値（タイトル、テキスト、数値、日付、チェックボックス、ラベル、担当者、リンクされたエントリー）を含むエントリー、そしてエントリー単位またはコレクション全体のコメントと変更履歴です。

変更の前に必ず確認: zenkit_create_entry はエントリーを追加し、zenkit_update_entry はフィールド値を変更し（ラベル、担当者、リンクされたエントリーでは値の置き換え、追加、削除を選べます）、zenkit_comment_on_entry はあなたの名前でコメントを投稿します。共有データが変わり、エントリーをフォローしている人に通知が届くこともあるため、AI は変更内容を示してあなたの承認を待ちます。数式フィールドと作成日時・更新日時のフィールドは読み取り専用です。

インストール時はオフ: zenkit_archive_entries。エントリーをアーカイブに移動します。アーカイブからは Zenkit アプリで復元できます。管理者が意図して有効にできます。完全に削除するツールはありません。

制限: Zenkit の上限は、ユーザーごとに 1 分あたり 200 リクエスト、IP アドレスごとに 1 分あたり 500 リクエストです。AI は個別の読み取りを何度も行うより、絞り込んだ 1 ページを読むことを優先します。エラー D2（Limit reached）が出たら、1 分待ってから再試行します。

よくあるエラー: 401 はキーが間違っているか、新しいキーに置き換えられたことを示します。403 はそのワークスペースやコレクションへのアクセス権がないこと、404 は ID が存在しないことを示します。C21 は Zenkit が受け付けないパラメーターや値があることを示し、多くはそのコレクションに存在しないフィールドキーが原因です。

このコネクターは、ワークスペース、コレクション、フィールドの作成や変更、ファイルのアップロード、Webhook の設定、アーカイブ済みエントリーの復元は行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Zenkit のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「Marketing コレクションで今週期限の未完了タスクはどれですか。担当者も教えてください。」
• 「『料金ページ更新』のタスクを『完了』にして、Website ラベルを追加してください。変更前に内容を見せてください。」
• 「Bugs コレクションにエントリーを作成してください。内容は Safari でチェックアウトボタンが動かない、優先度は高、担当は Lisa です。」
• 「すべての Zenkit ワークスペースから、山田プロジェクトに触れているエントリーを検索してください。」
• 「過去 7 日間に Product Roadmap コレクションで何が変わりましたか。誰が何にコメントしたかも教えてください。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続