セットアップガイド

このガイドでは、Phennecの初期セットアップから各ツールとの連携、そしてAIエージェント（Cursor）での利用開始までの手順を説明します。

1. アカウント作成

• コントロールパネルにアクセスします。
• Sign Up をクリックし、必要な情報を入力してアカウントを作成します。

2. プロジェクト作成

• サイドバーの Projects をクリックします。
• Add Project をクリックします。
• プロジェクト名を入力し、作成を完了します。

3. コネクター追加

作成したプロジェクトの画面から Connectors > Create Connector をクリックしてください。

GitLabの連携

GitLab 側

• GitLab にログイン
• Profile → Edit Profile → Access Tokens を開く
• Add new token をクリック（※）
  • Scopes で read_repository と read_api を選択
• Create token をクリックし、生成されたトークンをコピーする

Phennec コントロールパネル側

• GitLab コネクターを作成する
• GitLabリポジトリのURL を プロジェクトURL として入力し、Personal Access Token を トークン に貼り付ける
• Create を押下する
• Connectors 画面で、作成した GitLab コネクターの ••• メニューをクリック
• Sync Now を選択する

※ 連携には対象プロジェクトの Maintainer または Owner 権限が必要で、Personal Access Token で接続できない場合はプロジェクト内の Settings → Access Tokens から Project Access Token を作成してください

Google Driveの連携

Google Drive 側

• 連携したい Google Drive のフォルダを開く
• 共有 をクリック
• 以下のアカウントを 編集者 として追加する:
  syncer@phennec.iam.gserviceaccount.com

Phennec コントロールパネル側

• Google Drive コネクターを作成する
• Connectors 画面で、作成した Google Drive コネクターの ••• メニューをクリック
• Sync Now を選択する

Backlogの連携

Backlog 側

• 連携したい Backlog プロジェクトの URL をコピーする
• 個人設定 → API → 登録 を開く
• APIキーを発行し、コピーする

Phennec コントロールパネル側

• Backlog コネクターを作成する
• Backlog プロジェクトの URL と APIキー を入力する
• Create を押下する
• Connectors 画面で、作成した Backlog コネクターの ••• メニューをクリック
• Sync Now を選択する

Notionの連携

Notion 側

• 設定 → インテグレーション を開く（※）
• 新しいインテグレーション をクリックして作成する
• 作成したインテグレーションの設定画面を開く
• シークレットトークンを表示し、コピーする
• Phennec と連携したい Notion の親ページを開く
• ページ右上の … をクリック
• 接続 を選択し、作成したインテグレーションを追加する

Phennec コントロールパネル側

• Notion コネクターを作成する
• NotionページのURL を プロジェクトURL として入力し、シークレットトークンを トークン に貼り付ける
• Create を押下する
• Connectors 画面で、作成した Notion コネクターの ••• メニューをクリック
• Sync Now を選択する

※ インテグレーションを作成する権限がない場合、組織内で権限を持つ方に シークレットトークン の共有を依頼してください

DocBaseの連携

DocBase 側

• 連携したい DocBase グループの URL をコピーする
• アカウント設定 → アクセストークン → トークンを作成 を開く
• 以下を設定する
  • 操作対象グループ：連携対象のグループを選択
  • スコープ：読み取り
• トークンを作成し、コピーする

Phennec コントロールパネル側

• DocBase コネクターを作成する
• DocBase グループの URL と アクセストークン を入力する
• Create を押下する
• Connectors 画面で、作成した DocBase コネクターの ••• メニューをクリック
• Sync Now を選択する

4. Cursorでの利用 (MCP)

• Phennec コントロールパネルで プロフィールアイコン > MCP をクリックし、MCP設定画面を開く
• Quick Setup リンクをクリック
• ブラウザがCursorを開く許可を求めた場合は許可する
• Tools & MCP 設定画面に遷移し、Phennec MCPの詳細と個人トークンが自動入力されていることを確認する
• Install をクリックしてセットアップを完了する

この操作は一度だけ行えば完了です。

インストール後、Cursorのチャット画面（CMD+L）を開き、プロンプトに phennec と入れるだけでコンテキストが自動的に取得されます。
例: phennec @Codebase ログインページの仕組みを教えて

複数のプロジェクトがある場合、グローバルMCP接続を通じてすべてのプロジェクトにアクセスできます。コンテキストを正確に保つため、最初のプロンプトでプロジェクト名を指定し、プロジェクトごとに別のチャットを使用してください。