# AIコーディングエージェントとの連携 (/docs/mcp-setup)



## AIコーディングエージェントとは

Claude Code、Cursorなどのコーディングエージェントは、AI技術を使ってコーディング作業を支援してくれるツールです。AvaはMCP（Model Context Protocol）を通じてこれらのツールと連携し、作業の進捗を自動的にSlackに報告します。

<Accordions type="single">
  <Accordion title="MCPとは？">
    **MCP（Model Context Protocol）** は、AIアプリケーションが外部ツールやデータソースと連携するためのオープンな標準プロトコルです。

    MCPを使うことで、Claude CodeなどのAIエージェントが：

    * データベースにアクセスする
    * 外部APIを呼び出す
    * ファイルシステムを操作する
    * カスタムツールを実行する

    などの操作を安全に実行できます。

    **Avaとの関係:**

    * Ava はMCPサーバーとして動作します
    * Claude CodeなどのAIエージェントがMCPクライアントとしてAvaに接続します
    * AIエージェントはAvaが提供するツール（`start_task`、`update_task`など）を使って進捗を報告します

    詳しくは [MCP公式ドキュメント](https://modelcontextprotocol.io/docs/getting-started/intro) をご覧ください。
  </Accordion>
</Accordions>

## 設定方法

<Tabs items={['Codex', 'Claude Code', 'Cursor', 'VSCode']} persist groupId="coding-agent">
  <Tab value="Claude Code">
    ### 1. Claude Codeを起動

    お使いのエディタまたはCLIでClaude Codeを起動します。

    ### 2. MCP サーバーを設定

    `.mcp.json` ファイルを作成し、以下を追加：

    ```json
    {
      "mcpServers": {
        "ava": {
          "type": "http",
          "url": "https://ava-dusky-gamma.vercel.app/mcp"
        }
      }
    }
    ```

    **設定ファイルの場所:**

    * プロジェクト固有: プロジェクトルートに `.mcp.json`
    * グローバル: ホームディレクトリに `.mcp.json`

    ### 3. 初回接続と認証

    Claude CodeからAvaに初めて接続すると、ブラウザが開いて認証画面が表示されます。

    1. ブラウザで「許可」をクリック
    2. 認証が完了すると自動的にClaude Codeに戻ります

    ### 4. 接続の確認

    Claude Codeで以下のように尋ねてみてください：

    ```
    利用可能なMCPツールを教えて
    ```

    以下のツールが表示されれば成功です：

    * `start_task` - タスクを開始
    * `update_task` - 進捗を更新
    * `report_blocked` - ブロッキングを報告
    * `complete_task` - タスクを完了
    * `list_tasks` - タスク一覧を表示

    ### 5. Avaスキルをインストール（推奨）

    Avaの使い方をClaude Codeに教えるスキルをインストールすることで、より効果的に使えます。

    Claude Codeで以下のコマンドを実行：

    ```
    /plugin marketplace add yutakobayashidev/ava-skills
    ```

    次に、スキルをインストール：

    ```
    /plugin install ava-mcp-usage@ava-skills
    ```

    **スキルをインストールすると:**

    * Avaの使い方のベストプラクティスが自動的に適用されます
    * 自分で設定を考える手間が省けます（デフォルトプリセット）
    * プライバシーに配慮した報告が自動的に行われます

    もちろん、自分で[Claude Skills](https://support.claude.com/ja/articles/12512176-%E3%82%B9%E3%82%AD%E3%83%AB%E3%81%A8%E3%81%AF%E4%BD%95%E3%81%A7%E3%81%99%E3%81%8B)を作成したり、CLAUDE.mdに独自のルールを追記することで、報告の仕方をカスタマイズすることもできます。
  </Tab>

  <Tab value="Cursor">
    ### 1. Cursorを起動

    Cursorエディタを開きます。

    ### 2. MCP サーバーを設定

    `.cursor/mcp.json` ファイルを作成し、以下を追加：

    ```json
    {
      "mcpServers": {
        "ava": {
          "type": "http",
          "url": "https://ava-dusky-gamma.vercel.app/mcp"
        }
      }
    }
    ```

    **設定ファイルの場所:**

    * プロジェクト固有: `.cursor/mcp.json`（プロジェクトルート）
    * グローバル: `~/.cursor/mcp.json`（ホームディレクトリ）

    ### 3. 設定を反映

    Cursorを再起動するか、コマンドパレット（`Cmd+Shift+P` / `Ctrl+Shift+P`）から「Reload Window」を実行します。

    ### 4. 初回接続と認証

    1. Cursorの設定からMCPの設定画面を開く
    2. Avaサーバーの横にある「Connect」ボタンをクリック
    3. ブラウザが開いて認証画面が表示されます
    4. ブラウザで「許可」をクリック
    5. 認証が完了すると自動的にCursorに戻ります

    ### 5. 接続の確認

    Cursorのチャットで以下のように尋ねてみてください：

    ```
    利用可能なMCPツールを教えて
    ```

    Avaのツール一覧が表示されれば成功です。
  </Tab>

  <Tab value="VSCode">
    ### 1. VSCodeを起動

    VSCodeエディタを開きます。

    ### 2. MCP サーバーを設定

    ワークスペースのルートに `.vscode/mcp.json` ファイルを作成し、以下を追加：

    ```json
    {
      "servers": {
        "ava": {
          "type": "http",
          "url": "https://ava-dusky-gamma.vercel.app/mcp"
        }
      }
    }
    ```

    **設定ファイルの場所:**

    * ワークスペース固有: `.vscode/mcp.json`（ワークスペースルート）

    **または、コマンドパレットから設定:**

    1. `Cmd/Ctrl + Shift + P` でコマンドパレットを開く
    2. `MCP: Add Server` を選択
    3. サーバータイプとして `http` を選択
    4. サーバー情報を入力

    ### 3. IntelliSenseサポート

    VSCodeでは MCP 設定ファイルに IntelliSense が提供されているため、設定の入力補完が利用できます。エディタ内の「Add Server」ボタンをクリックして、新しいサーバーのテンプレートを追加することもできます。

    ### 4. 初回接続と認証

    1. VSCodeでプロジェクトを開く
    2. MCP サーバーに初めて接続すると、ブラウザが開いて認証画面が表示されます
    3. ブラウザで「許可」をクリック
    4. 認証が完了すると自動的にVSCodeに戻ります

    ### 5. 接続の確認

    VSCodeのチャットで以下のように尋ねてみてください：

    ```
    利用可能なMCPツールを教えて
    ```

    以下のツールが表示されれば成功です：

    * `start_task` - タスクを開始
    * `update_task` - 進捗を更新
    * `report_blocked` - ブロッキングを報告
    * `complete_task` - タスクを完了
    * `list_tasks` - タスク一覧を表示
  </Tab>

  <Tab value="Codex">
    ### 1. Codexの設定ファイルを開く

    Codex CLI と IDE 拡張は同じ設定ファイル（`~/.codex/config.toml`）を共有します。

    ### 2. RMCP クライアントを有効化（OAuth 用）

    AvaのMCPサーバーはOAuth 2.1で認可を行います。`[features]` セクションに以下を追加し、RMCPクライアントを有効化してください。

    ```toml
    [features]
    rmcp_client = true
    ```

    ### 3. Ava サーバーを登録

    同じ `config.toml` に以下を追記します。

    ```toml
    [mcp_servers.ava]
    url = "https://ava-dusky-gamma.vercel.app/mcp"
    ```

    CLI から設定する場合は `codex mcp --help` を参照してください。

    ### 4. Codex を再起動して接続

    Codex を再起動し、ターミナルで `codex mcp login ava` を実行してブラウザ認可を許可してください。

    ### 5. 接続確認

    `codex` のチャットで「利用可能な MCP ツールを教えて」と入力し、`start_task` などの Ava ツールが表示されれば完了です。
  </Tab>
</Tabs>

## 他のMCPツールとの併用

Avaは**進捗の共有とチームへの透明性確保に特化したツール**です。タスク管理自体は、GitHub IssuesやLinearなどの専用サービスを使うことを推奨します。

### おすすめの併用パターン

以下のMCPツールと組み合わせることで、より効率的な開発フローを実現できます：

#### GitHub MCP

GitHubのIssue管理とAvaの進捗報告を組み合わせることで、タスク管理とチームへの透明性を両立できます。

```json
{
  "mcpServers": {
    "ava": {
      "type": "http",
      "url": "https://ava-dusky-gamma.vercel.app/mcp"
    },
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}
```

**使用例:**

1. GitHub MCPでIssueを取得・作成
2. Avaで作業開始を報告（Issueタイトルを指定）
3. 進捗はAvaが自動でSlackに投稿
4. 完了時、Pull RequestのURLをAvaが報告

#### GitHub CLI（gh）

GitHub CLIを使ってIssueやPull Requestを直接操作することもできます。GitHub CLIはMCPサーバーではありませんが、コーディングエージェントから直接呼び出すことで、タスク管理を効率化できます。

#### Linear MCP

Linearでタスク管理している場合は、Linear MCPとの併用が便利です。

```json
{
  "mcpServers": {
    "ava": {
      "type": "http",
      "url": "https://ava-dusky-gamma.vercel.app/mcp"
    },
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
    }
  }
}
```

## 次のステップ

設定が完了したら、[使い方ガイド](/docs/usage-guide)で実際の使用方法を確認しましょう。

## トラブルシューティング

接続できない場合は、[トラブルシューティング](/docs/troubleshooting)を確認してください。