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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.genesis.autify.com/features-ko/settings/connection-settings/mcp-server.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.