> ## Documentation Index
> Fetch the complete documentation index at: https://docs.caret.so/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP（Model Context Protocol）

> Model Context Protocolを使用して、Claude Desktop、Cursor、WindsurfなどのAIアシスタントにCaretを接続します。

MCPは、AIアシスタントがCaretのミーティングデータに直接アクセスできるオープンプロトコルです。ワークフローから離れることなく、過去のミーティングについてAIに質問したり、ナレッジベースを検索したり、文字起こしを参照したりできます。

## 対応クライアント

<CardGroup cols={3}>
  <Card title="Claude Desktop" icon="message-bot">
    AnthropicのデスクトップAIアシスタント。
  </Card>

  <Card title="Cursor" icon="code">
    AI搭載コードエディター。
  </Card>

  <Card title="すべてのMCPクライアント" icon="plug">
    Model Context Protocolに対応するすべてのクライアント。
  </Card>
</CardGroup>

## クイックセットアップ

<Tabs>
  <Tab title="Claude Desktop">
    <Steps>
      <Step title="設定を開く">
        Claude Desktopを開き、**Settings > MCP Servers** に移動します。
      </Step>

      <Step title="サーバーを追加">
        **Add** をクリックし、サーバーURLを入力します：

        ```
        https://api.caret.so/mcp
        ```
      </Step>

      <Step title="サインイン">
        Claudeがブラウザウィンドウを開きます。Googleアカウントでサインインしてください。
      </Step>

      <Step title="ワークスペースを選択">
        接続するCaretワークスペースを選択します。
      </Step>

      <Step title="利用開始">
        接続完了です。Claudeにミーティングについて質問してみましょう。
      </Step>
    </Steps>

    `claude_desktop_config.json` で手動でサーバーを追加することもできます：

    ```json theme={null}
    {
      "mcpServers": {
        "caret": {
          "type": "streamable-http",
          "url": "https://api.caret.so/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Cursor">
    <Steps>
      <Step title="MCP設定を開く">
        **Cursor Settings > MCP** に移動します。
      </Step>

      <Step title="サーバーを追加">
        **Add new MCP server** をクリックし、URLに `https://api.caret.so/mcp` を入力します。
      </Step>

      <Step title="認証">
        ブラウザウィンドウが表示されたら、サインインしてワークスペースを選択します。
      </Step>
    </Steps>

    または、プロジェクトの `.cursor/mcp.json` に直接追加します：

    ```json theme={null}
    {
      "mcpServers": {
        "caret": {
          "type": "streamable-http",
          "url": "https://api.caret.so/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="その他のクライアント">
    MCP対応クライアントで以下の設定を使用してください：

    * **サーバーURL**: `https://api.caret.so/mcp`
    * **トランスポート**: Streamable HTTP
    * **認証**: OAuth 2.0（ほとんどのクライアントで自動処理）

    クライアントがOAuthに対応していない場合は、以下のAPIキー方式を使用してください。
  </Tab>
</Tabs>

## APIキー認証

MCPクライアントがOAuthに対応していない場合、APIキーで認証できます。

<Steps>
  <Step title="APIキーを作成">
    Caretの **設定 > 開発者** で **APIキーを作成** をクリックします。
  </Step>

  <Step title="スコープを割り当て">
    MCPツールへのフルアクセスには `notes` と `users` スコープを選択します。
  </Step>

  <Step title="クライアントを設定">
    MCPクライアントの認証ヘッダーにAPIキーをBearerトークンとして設定します。
  </Step>
</Steps>

<Warning>
  APIキーは安全に保管してください。公開リポジトリやクライアントサイドのコードにキーを公開しないでください。
</Warning>

## できること

すべてのツールは**読み取り専用**で、ワークスペース内に限定されています。

| 機能           | プロンプト例                |
| :----------- | :-------------------- |
| ミーティングノートの一覧 | 「先週のミーティングを見せて」       |
| ノートの詳細取得     | 「Q3企画会議では何を議論した？」     |
| タイトルでノートを検索  | 「料金に関するミーティングを探して」    |
| ナレッジベースの検索   | 「顧客は競合他社について何と言っていた？」 |
| ワークスペース情報の表示 | 「どのワークスペースに接続している？」   |
| チームメンバーの一覧   | 「チームには誰がいる？」          |

ツールスキーマとパラメータの詳細は [MCPツールリファレンス](/api-reference/mcp/tools) を参照してください。

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

| 問題             | 解決方法                                              |
| :------------- | :------------------------------------------------ |
| 接続失敗           | URLが正確に `https://api.caret.so/mcp` であることを確認してください |
| 認証エラー          | 再認証するか、APIキーのスコープが正しいことを確認してください                  |
| 結果が返されない       | ワークスペースに完了状態のミーティングノートがあることを確認してください              |
| ワークスペースが見つからない | 選択したワークスペースのメンバーであることを確認してください                    |