> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/features-ja/settings/connection-settings/mcp-server.md).

# MCPサーバー

本記事では、Autify Genesis の **MCPサーバー** 設定について説明します。Genesis を MCP（Model Context Protocol）対応クライアントと連携するための接続情報を確認できます。

## サーバーURL

MCP 対応クライアント（Claude Desktop、Cursor、VS Code など）に設定するエンドポイント URL を確認できます。 **URLをコピー** をクリックしてコピーします。

<figure><img src="/files/4kJ9tH4k7av6vl77QCkb" alt="サーバーURLのスクリーンショット"><figcaption><p>サーバーURL</p></figcaption></figure>

## 認証

Genesis MCPサーバーでは、OAuth 2.1 with PKCE に加えて API キーの Bearer 認証も利用できます。

* OAuth を使う場合は、初回接続時にブラウザが開き、アクセスを承認します。
* API キーを使う場合は、`Authorization: Bearer {APIキー}` ヘッダーを設定します。API キーの作成方法は [APIキー管理](/features-ja/settings/organization-settings/api-key-management.md) を参照してください。

## はじめに（クライアント別の設定手順）

利用するクライアントに応じて、次の手順で Genesis MCPサーバーを設定します。

### Claude Desktop

Claude Desktop は stdio 接続のみサポートしています。`mcp-remote` をブリッジとして使用し、`claude_desktop_config.json` に以下を追加してください。`SERVER-URL` は Genesis の **サーバーURL** に置き換えます。

```json
{
  "mcpServers": {
    "genesis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "SERVER-URL"
      ]
    }
  }
}
```

または、Claude Connectors（設定 > コネクタ > カスタムコネクタを追加）を使用して、設定ファイルを編集せずに直接接続することもできます。詳細については、Claude Support の [Getting started with custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp) を参照してください。

### Cursor / VS Code

`.cursor/mcp.json` または `.vscode/mcp.json` に以下を追加してください。`SERVER-URL` は Genesis の **サーバーURL** に置き換えます。

```json
{
  "mcpServers": {
    "genesis": {
      "url": "SERVER-URL"
    }
  }
}
```

### Claude Code

ターミナルで以下のコマンドを実行して Genesis MCPサーバーを追加してください。詳細については、Claude Code ドキュメントの [Model Context Protocol (MCP)](https://code.claude.com/docs/en/mcp) を参照してください。

```bash
claude mcp add --transport http genesis \
  https://genesis.autify.com/api/mcp
```

{% hint style="info" %}
OAuth を使うクライアントでは、初回接続時にブラウザが開き、アクセスを承認します。
{% endhint %}

<figure><img src="/files/sJnZFGDvig7DW6mOtVwQ" alt="OAuth 認証画面のスクリーンショット"><figcaption><p>OAuth 認証画面</p></figcaption></figure>

## 利用可能なツール

接続された MCP クライアントから呼び出せるツールはカテゴリ別に整理されており、設定ページの **利用可能なツール** カードで最新の一覧と検索ができます。各ツールには **読み取り** / **書き込み** / **破壊的** のいずれかのバッジが付与されます。

主なカテゴリと代表的なツールは次のとおりです。

| カテゴリ         | 代表的なツール                                                                                                                                                                                                                                                 |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 組織           | `get_organization`、`list_organizations`                                                                                                                                                                                                                 |
| ワークスペース      | `list_workspaces`、`get_workspace`、`list_codebases`                                                                                                                                                                                                      |
| ワークフローテンプレート | `list_workflow_templates`、`get_workflow_template`、`create_workflow_template`、`update_workflow_template`、`duplicate_workflow_template`、`archive_workflow_template`                                                                                       |
| ワークフロー実行     | `run_workflow`、`get_workflow_execution`、`list_workflow_executions`、`cancel_workflow_execution`、`resume_workflow_execution`、`get_workflow_execution_usage`、`list_artifacts`、`get_artifact`、`get_artifact_traces`                                         |
| ファイル         | `list_files`、`get_file`、`get_file_content`、`create_file`、`update_file_content`、`delete_file`、`move_file`、`update_file_labels`、`list_file_labels`、`reindex_file`、`list_file_versions`、`delete_file_version`、`restore_file_version`、`rename_file_version` |
| ディレクトリ       | `list_directories`、`list_directory_contents`、`create_directory`、`update_directory`、`delete_directory`、`move_directory`、`get_directory_breadcrumbs`                                                                                                      |
| ナレッジベース      | `search_knowledge_base`                                                                                                                                                                                                                                 |
| メトリクスダッシュボード | `list_metrics_widgets`、`list_metrics_widget_source_files`、`list_metrics_widget_versions`、`discover_metrics_widget_fields`、`get_metrics_widget_chart_data`、`create_metrics_widget`、`update_metrics_widget`                                               |
| 動画           | `analyze_video`                                                                                                                                                                                                                                         |
| Bash         | `bash`                                                                                                                                                                                                                                                  |

ツールごとの詳細な説明・パラメーター・読み取り/書き込み/破壊的の区分は、 **利用可能なツール** カードの検索ボックスや、各 MCP クライアントが取得するツール定義から確認できます。