マニュアル

Claude連携は、Claudeデスクトップアプリ（Windows・macOS）に拡張機能を追加して、Claudeとの会話からGeckoFlagを操作する機能です。課題・プロジェクト・Wiki・ノートの検索・閲覧・作成・更新と、ガントチャートのExcel出力ができます。拡張機能は利用者のPC上で動き、利用者のGeckoFlagとだけ直接通信します。すべての操作は、APIトークンの持ち主のユーザー権限で行われます。

管理者の設定

1. 1サイドメニューの設定を開き、Claude連携カードの編集をクリックします。
2. 2Claude連携を有効にするをオンにします（初期状態は無効）。Claudeに作成・変更もさせる場合は、書き込みを許可もオンにして保存します。書き込みを許可しない場合、すべてのトークンが読み取り専用になります。
3. 3ユーザー一覧で対象のユーザーの編集を開き、Claude連携（API）の利用を許可をオンにして更新するをクリックします。「AIでの登録を許可」とは別の設定です。許可を外すと、そのユーザーのAPIトークンはすべて削除されます。

APIトークンを作成する

1. 1サイドメニューのプロフィールを開き、APIトークンの欄で、トークン名・有効期限（30日・90日・365日・無期限。初期値は90日）・権限（読み取りまたは読み取りと書き込み）を指定して、トークンを作成します。
2. 2表示されたトークン（gfk_ で始まる文字列）をコピーします。トークンは作成直後に一度だけ表示されます。同じ欄に表示される「拡張機能に入力するURL」も控えておきます。

• トークンは1人5つまで作成でき、使わなくなったものはプロフィールからいつでも削除できます。
• トークンを作成すると、本人にお知らせメールが届きます。パスワードを変更すると、その人のトークンはすべて削除されます。

Claudeデスクトップアプリに設定する

1. 1ClaudeデスクトップアプリのSettings（設定）→Extensions（拡張機能）を開き、GeckoFlagの拡張機能ファイル（.mcpb）をドラッグ＆ドロップしてInstallをクリックします。ファイルのダブルクリック、またはAdvanced settingsからもインストールできます。拡張機能ファイルは、GeckoFlagのご購入後にダウンロードできるファイルに同梱されています。
2. 2設定画面で次の項目を入力し、Saveをクリックします。
   • GeckoFlag URL（必須）：控えておいたURL。https:// が必要です（http:// はlocalhost・*.test・*.localのみ）。
   • API token（必須）：コピーしたトークン。伏せ字で保存されます。
   • Export folder（任意）：ガントチャートのExcelの保存先。空欄ならダウンロードフォルダーに保存されます。
   
3. 3Claudeに「GeckoFlagに接続できているか確認して」と頼みます。トークンの持ち主、GeckoFlagのバージョン、書き込みができるかが表示されれば完了です。

画面つきの詳しい手順は、Claude連携のご利用手順をご覧ください。書き込み操作は、Claudeの拡張機能の設定で「毎回確認」にしておくことをおすすめします。

できること

• 課題: 検索（プロジェクト・ステータス・担当者・登録者・優先度・キーワード・期限・親課題）、詳細とコメントの閲覧、作成（親課題・通知先の指定も可）、項目の変更、コメントの投稿、ステータスの変更。
• プロジェクト: 一覧・詳細の閲覧、作成（ゲスト以外）、名前・説明・オーナー・期間の変更と完了／未完了の切り替え、メンバーの追加・削除（オーナー・管理者）。
• Wiki: 閲覧、タイトル・本文の書き換え、末尾への追記（プロジェクトのメンバー・管理者）。
• ノート: 自分のノートの一覧・検索・閲覧・作成・書き換え・追記。
• マスター: 課題タイプ・ステータス・優先度・職種（所属）の追加と、名前・色の変更（管理者）。
• ガントチャート: プロジェクトの課題（最大5,000件）をExcelファイルにしてPCに保存。期間が120日を超えると1列＝1週になります。
• ユーザー検索: 名前でユーザーを探す（IDとロールのみ。メールアドレスは返しません）。

課題は「WEB-12」のようなキーで指定できます。書き込みには、「読み取りと書き込み」のトークンと、サイトの「書き込みを許可」の両方が必要です。