> ## 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を使用してAIアシスタントをCaretに接続します

Caretは、Model Context Protocol（MCP）サーバーを提供しており、AIアシスタントがワークスペースデータ（ミーティングノート、文字起こし、ナレッジベース、チーム情報）にアクセスできるようにします。

## サーバー情報

| プロパティ   | 値                          |
| :------ | :------------------------- |
| 名前      | Caret MCP Server           |
| バージョン   | 1.0.0                      |
| エンドポイント | `https://api.caret.so/mcp` |
| トランスポート | Streamable HTTP            |

## プロトコルエンドポイント

| メソッド     | パス     | 説明                    |
| :------- | :----- | :-------------------- |
| `POST`   | `/mcp` | MCPツール呼び出しの実行         |
| `GET`    | `/mcp` | サーバーメタデータと利用可能なツールの取得 |
| `DELETE` | `/mcp` | セッションの終了              |

## 認証

<CardGroup cols={2}>
  <Card title="OAuth 2.0 with PKCE" icon="shield-check" href="/api-reference/mcp/authentication">
    Claude
    DesktopやCursorなどの対話型クライアントに推奨。ほとんどのMCPクライアントで自動的に処理されます。
  </Card>

  <Card title="APIキー" icon="key" href="/api-reference/mcp/authentication#api-key-authentication">
    プログラムからのアクセスやOAuthに対応していないクライアント向け。
  </Card>
</CardGroup>

## 利用可能なツール

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

<CardGroup cols={2}>
  <Card title="ノート" icon="file-lines" href="/api-reference/mcp/tools#caret_list_notes">
    文字起こしやサマリーを含むミーティングノートの一覧取得、詳細取得、検索。
  </Card>

  <Card title="ナレッジ検索" icon="magnifying-glass" href="/api-reference/mcp/tools#caret_search_knowledge">
    ミーティングコンテンツとワークスペースのナレッジベースをセマンティック検索。
  </Card>

  <Card title="ワークスペース" icon="building" href="/api-reference/mcp/tools#caret_get_workspace">
    名前、設定、許可ドメインなどのワークスペースメタデータを取得。
  </Card>

  <Card title="メンバー" icon="users" href="/api-reference/mcp/tools#caret_list_members">
    ロールやフォルダ割り当て情報を含むワークスペースメンバーの一覧取得。
  </Card>
</CardGroup>

## ディスカバリーエンドポイント

MCPクライアントは、以下のwell-knownエンドポイントを使用してサーバー機能を自動検出できます：

| エンドポイント                                           | 説明                  |
| :------------------------------------------------ | :------------------ |
| `GET /.well-known/oauth-authorization-server`     | OAuth認可サーバーメタデータ    |
| `GET /.well-known/oauth-protected-resource`       | 保護リソースメタデータ         |
| `GET /mcp/.well-known/oauth-authorization-server` | MCPプレフィックス認可メタデータ   |
| `GET /mcp/.well-known/oauth-protected-resource`   | MCPプレフィックスリソースメタデータ |
