셀프 호스팅 설치의 MCP

Nodaro MCP 서버를 사용하면 Claude, Cursor, Cline, Continue, Goose, ChatGPT 같은 AI 클라이언트가 사용자를 대신해 셀프 호스팅 설치의 도구를 쓸 수 있습니다. 기본적으로는 꺼져 있습니다. 활성화하려면 MCP 전용 호스트 이름을 정하고, 그 호스트 이름을 API로 라우팅하고, 변수 두 개를 설정하세요. 그러면 사용자는 자신의 클라이언트에서 OAuth로 내 설치에 로그인합니다.

MCP 제공 방식

• API가 MCP를 제공합니다. 경로는 /mcp이고, nodaro 컨테이너 안의 포트 9000에서 제공됩니다.
• 포트 3000의 웹 서버는 MCP 요청을 거부합니다. 앱의 기본 주소로 /mcp를 요청하면 wrong_mcp_host 오류와 실제 엔드포인트 주소와 함께 405로 응답합니다.
• 따라서 MCP에는 전용 호스트 이름이 필요합니다. mcp.nodaro.example.com처럼, 트래픽이 API에 직접 닿는 호스트 이름입니다.
• 로그인은 기본 도메인에서 이루어집니다. OAuth 검색 문서 /.well-known/oauth-authorization-server와 동의 화면은 PUBLIC_URL에서 제공됩니다.

MCP 활성화

  nodaro:
    ports:
      - "3000:3000"
      - "127.0.0.1:9000:9000"

railway domain add mcp.your-domain.com --service backend

MCP_ENABLED=true                              # required; the default is off
MCP_PUBLIC_URL=https://mcp.your-domain.com    # the hostname from step 1

curl https://mcp.your-domain.com/.well-known/oauth-protected-resource
curl https://your-domain.com/.well-known/oauth-authorization-server

등록할 수 있는 클라이언트

MCP 클라이언트는 OAuth로 로그인합니다. 지원되는 클라이언트는 동적 클라이언트 등록(RFC 7591)으로 내 설치에 스스로 등록합니다. 이를 제어하는 변수는 두 개이며, 기본값은 대부분의 설치에 적합합니다.

기본 허용 목록은 Claude, Claude Code, Cursor, Cline, Continue, Goose, ChatGPT, OpenAI, Lovable, Gemini, Gemini CLI, Codex, MCP Inspector, mcp-inspector입니다. 내 클라이언트를 추가하려면 전체 목록을 설정하세요.

MCP_DCR_ALLOWLIST=Claude,Cursor,Cline,Continue,Goose,YourCustomClient

권장 모드는 allowlist입니다.

클라이언트가 할 수 있는 것

MCP 서버는 이미지, 동영상, 오디오, 캐릭터, 장소, 오브젝트 생성 도구와 갤러리, 워크플로, 앱, 저장된 컴포넌트, 모델용 도구를 제공합니다. 각 사용자는 내 설치에서 자신의 계정으로 작업합니다. MCP 도구 레퍼런스와 MCP 문제 해결을 참조하세요.