> 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-ko/settings/connection-settings/mcp-server.md).

# MCP 서버

이 문서에서는 Autify Genesis의 **MCP 서버** 설정을 설명합니다. Genesis를 MCP(Model Context Protocol) 지원 클라이언트와 연동하기 위한 연결 정보를 확인할 수 있습니다.

## 서버 URL

MCP 지원 클라이언트(Claude Desktop, Cursor, VS Code 등)에 설정할 엔드포인트 URL을 확인할 수 있습니다. **URL 복사**를 클릭하여 복사하십시오.

## 인증

Genesis MCP 서버에서는 OAuth 2.1 with PKCE에 더해 API 키의 Bearer 인증도 이용할 수 있습니다.

* OAuth를 사용하는 경우, 최초 연결 시 브라우저가 열려 액세스를 승인합니다.
* API 키를 사용하는 경우, `Authorization: Bearer {API 키}` 헤더를 설정합니다. API 키 생성 방법은 [API 키 관리](/features-ko/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 %}

## 사용 가능한 도구

연결된 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 클라이언트가 가져오는 도구 정의에서 확인할 수 있습니다.