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

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

Shortcut + Gemini

AI に Shortcut で作業させます。Shortcut の検索演算子でストーリーを検索し、タスク、コメント、履歴付きのストーリー、エピック、イテレーション、目標、チーム、ワークフロー、ラベルを参照し、あなたの確認後にストーリーの作成、更新、コメント追加ができます。個人用 API トークンを使います。

前提条件

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

SHORTCUT_API_TOKEN

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

1. Shortcut でアバターをクリックし、Settings → Your Account → API Tokens（https://app.shortcut.com/settings/account/api-tokens）を開きます。
2. AnythingMCP などの名前を入力して Generate Token をクリックします。トークンは一度しか表示されません。
3. トークンを SHORTCUT_API_TOKEN に貼り付けて、コネクタをインストールします。Shortcut-Token ヘッダーで Shortcut にのみ送信されます。
4. shortcut_get_current_member で設定を確認します。あなたが誰か、メンション名、ワークスペースが表示されます。

トークンはあなたとして動作します: 作成したワークスペースで、あなたの権限のまま動きます。AI が書いたストーリーやコメントはあなたの名前で表示されます。複数の Shortcut ワークスペースで作業する場合は、ワークスペースごとにトークンを作成してください。

変更はあなたの承認後にのみ: shortcut_create_story、shortcut_update_story、shortcut_add_story_comment はワークスペースを即座に変更し、フォロワーに通知します。AI は先にストーリー、項目、コメントの文面を示し、はっきりした承認を待ちます。shortcut_delete_story はインストール時にオフになっています。削除したストーリーは復元できないため、shortcut_update_story でアーカイブするほうが安全です。

Shortcut と同じように検索: shortcut_search_stories と shortcut_search_epics は Shortcut の検索演算子に対応しています。あなたが普通の言葉で尋ねれば、AI がクエリを組み立てます。

• owner:jane、requester:jane、team:"Mobile"、epic:"Checkout redesign"、iteration:"Sprint 12"、label:"customer"、state:"In Progress"、type:bug、estimate:3。
• is:started、is:done、is:blocked、is:overdue、has:owner、has:deadline、has:comment。
• 日付: created:2026-10-01..2026-10-15、updated:today、completed:yesterday、due:*..2026-10-31。
• 演算子の前に感嘆符を付けると除外になります。例: owner:jane is:started !is:archived type:bug。

読み取れる内容: 説明、タスク、コメント、リンク、完全な変更履歴（誰が何をいつ動かしたか）付きのストーリー、コメント付きのエピック、イテレーション、目標、チーム、ステートを含むワークフロー、ラベル、プロジェクト、メンバー。ストーリーを移動するときは、AI が先にワークフローのステートを調べてから設定します。

ページングと制限: 検索結果は既定で 25 件、1 ページ最大 250 件です。たどれるのは最初の 1000 件までなので、AI は条件を絞り込みます。トークンごとに 1 分あたり 200 リクエストです。

よくあるエラー: 401: トークンが間違っているか削除されています。新しいトークンを生成してください。404: その ID はこのワークスペースに存在しません。400 または 422: 値が受け付けられません（別のワークフローのステートなど）。どの値かは Shortcut がメッセージで示します。

対象外: エピック、イテレーション、ラベル、コメントの削除、Docs、ファイルと添付、カスタムフィールドの編集、ストーリーテンプレート、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 が Shortcut のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「今、私が抱えている仕事は？着手済みでまだ完了していない私のストーリーを、エピックとイテレーション付きで一覧にしてください。」
• 「Sprint 12 で完了したバグと、まだ残っているバグはどれですか？」
• 「ストーリー 4521 の履歴を見せてください。誰がいつ Ready for Review に移動しましたか？」
• 「Payments チームに、バグのストーリー『期限切れカードでチェックアウトが失敗する』をステート Unstarted、担当 Jane で作成してください。作成する前に内容を見せてください。」
• 「ストーリー 4521 に、修正がステージングに入ったとコメントして、Ready for Review に移動してください。先に確認してください。」

FAQ

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

次のステップ

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