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 키 관리 참조.

시작하기(클라이언트별 설정 절차)

이용하는 클라이언트에 따라 다음 절차로 Genesis MCP 서버를 설정합니다.

Claude Desktop

Claude Desktop은 stdio 연결만 지원합니다. mcp-remote를 브리지로 사용하여 claude_desktop_config.json에 다음을 추가하십시오. SERVER-URL은 Genesis의 서버 URL로 대체합니다.

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

또는 Claude Connectors(설정 > 커넥터 > 사용자 지정 커넥터 추가)를 사용하여 설정 파일을 편집하지 않고 직접 연결할 수도 있습니다. 자세한 내용은 Claude Support 문서의 Getting started with custom connectors using remote MCP 참조.

Cursor / VS Code

.cursor/mcp.json 또는 .vscode/mcp.json에 다음을 추가하십시오. SERVER-URL은 Genesis의 서버 URL로 대체합니다.

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

Claude Code

터미널에서 다음 명령을 실행하여 Genesis MCP 서버를 추가하십시오. 자세한 내용은 Claude Code 문서의 Model Context Protocol (MCP) 참조.

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

OAuth를 사용하는 클라이언트에서는 최초 연결 시 브라우저가 열려 액세스를 승인합니다.

사용 가능한 도구

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