다른 MCP 클라이언트 연결하기

Claude와 ChatGPT 외에도 HTTP를 통한 원격 서버와 OAuth 로그인을 지원하는 모든 MCP 클라이언트를 쓸 수 있습니다. 예를 들어 Cursor 같은 IDE나 테스트용 MCP Inspector가 있습니다. 이 글은 이런 클라이언트를 직접 설정하거나 자체 연동을 만드는 분을 위한 것입니다.

#핵심 정보

서버 URL

https://dock.at-harbor.com/mcp

전송 방식

상태 없는 Streamable HTTP입니다. 모든 요청은 JSON-RPC 메시지(또는 배치)를 담은 POST이며, 응답은 JSON으로 돌아옵니다. 세션 ID도 서버 스트림도 없습니다.

프로토콜 버전

2025-11-25, 2025-06-18, 2025-03-26

메서드

initialize, ping, tools/list, tools/call입니다. 서버는 resources나 prompts를 제공하지 않습니다.

로그인

PKCE(S256)를 쓰는 OAuth 2.1입니다. 토큰이 없으면 서버가 401로 응답하고 WWW-Authenticate 헤더에서 메타데이터를 안내합니다.

#클라이언트 설정하기

1. 클라이언트에서 원격 MCP 서버를 추가합니다(보통 “Remote”, “HTTP”, “Streamable HTTP”라고 부름)
2. URL에 https://dock.at-harbor.com/mcp을 입력합니다
3. 클라이언트 ID와 시크릿은 비워 둡니다. 클라이언트가 스스로 등록합니다
4. 연결을 시작하면 브라우저에서 로그인이 열리고 이어서 LinkHarbor 동의 페이지가 나타납니다
5. 워크스페이스와 권한을 고르고 “허용”을 클릭합니다

설정 이름은 프로그램마다 다릅니다. 예를 들어 MCP Inspector에서는 “Streamable HTTP” 전송 방식을 고릅니다.

#OAuth 흐름 자세히 보기

1. 클라이언트가 토큰 없이 MCP 서버를 호출하고, 리소스 메타데이터를 가리키는 401을 받습니다
2. 인가 서버 메타데이터(엔드포인트, 지원 방식, 권한)를 읽습니다
3. Dynamic Client Registration 또는 https URL의 클라이언트 메타데이터 문서로 스스로 등록합니다
4. PKCE와 resource=https://dock.at-harbor.com/mcp을 포함한 인가 요청으로 브라우저를 엽니다
5. 나는 로그인하고 동의 페이지에서 결정합니다
6. 클라이언트가 코드를 액세스 토큰과 리프레시 토큰으로 교환합니다

클라이언트가 아무 권한도 요청하지 않으면 모든 권한이 요청되며, 동의 페이지에서 여전히 줄일 수 있습니다. 이미 교체된 리프레시 토큰이 다시 쓰이면 LinkHarbor는 보안을 위해 연결 전체를 종료합니다.

#리디렉션 주소 규칙

• https 주소
• http는 내 컴퓨터의 루프백 주소에만 허용(데스크톱 클라이언트와 IDE용)
• 역방향 도메인 표기의 사용자 지정 앱 스킴
• 클라이언트당 최대 10개 주소, 프래그먼트 불가

앱이 등록되지 않은 주소를 보내면 LinkHarbor가 중단합니다: “앱이 등록되지 않은 반환 주소를 보냈습니다. 요청이 중단되었습니다.”

#개발자용 디스커버리 주소

#알 수 없는 앱

리디렉션 주소가 모두 claude.ai, claude.com, chatgpt.com, openai.com에 있는 앱은 알려진 앱으로 간주됩니다. localhost로 돌아오는 내 컴퓨터의 프로그램(Claude Code, Codex, IDE 등)은 동의 페이지에 “LinkHarbor가 모르는 앱입니다. 이 앱은 내 컴퓨터에서 실행 중입니다. 방금 직접 실행한 경우에만 계속하세요.” 안내를, 아래쪽에 “선택 후 내 컴퓨터의 앱으로 돌아갑니다.”를 보여 줍니다. 그 밖의 알 수 없는 웹 앱은 “LinkHarbor가 모르는 앱입니다. 직접 시작했고 …을(를) 신뢰하는 경우에만 계속하세요.” 안내를 보여 주며, … 자리에는 해당 앱의 주소가 들어갑니다. 방금 직접 클라이언트를 설정했다면 둘 다 정상입니다. 로고는 앱이 로고를 보낼 때만 나타납니다. 직접 로그인을 시작하지 않았다면 “거부”를 클릭하세요.