Claude를 LinkHarbor에 연결하기

Claude에서는 LinkHarbor를 사용자 지정 커넥터로 추가할 수 있습니다. 서버 URL만 있으면 됩니다. Claude가 LinkHarbor에 스스로 등록하고, 나는 브라우저에서 한 번 접근을 확인합니다. 그 뒤 Claude가 채팅에서 페이지를 읽고 편집할 수 있습니다.

#시작하기 전에

• LinkHarbor 계정(Creator Free를 포함한 모든 플랜)
• 사용자 지정 커넥터를 쓸 수 있는 Claude 계정
• 서버 URL: https://dock.at-harbor.com/mcp

사용자 지정 커넥터를 추가할 수 있는지는 Claude 플랜에 따라 다릅니다. 조직에서는 관리자가 먼저 사용자 지정 커넥터를 허용해야 할 수도 있습니다.

#Claude에 커넥터 추가하기

1. 브라우저나 데스크톱 앱에서 Claude를 엽니다
2. 설정의 커넥터 섹션으로 갑니다
3. 사용자 지정 커넥터를 추가하는 옵션을 고릅니다(보통 “Add custom connector”(사용자 지정 커넥터 추가))
4. 이름을 입력합니다. 예: “LinkHarbor”
5. URL에 https://dock.at-harbor.com/mcp을 입력하고 저장합니다
6. 새 커넥터에서 “Connect”(연결)를 클릭합니다

#LinkHarbor에서 접근 승인하기

“Connect”를 클릭하면 LinkHarbor가 있는 브라우저 창이 열립니다. 로그인되어 있지 않으면 먼저 로그인합니다(설정했다면 2단계 인증 확인 포함). 그다음 동의 페이지가 나타납니다.

“…에서 LinkHarbor 계정 접근을 요청합니다”

앱 이름이 들어간 제목입니다. 브라우저의 Claude나 ChatGPT 같은 잘 알려진 앱은 경고를 표시하지 않습니다. 로고는 앱이 로고를 보낼 때만 나타납니다.

“워크스페이스”

Claude가 접근할 수 있는 워크스페이스입니다. 내 역할이 요청한 권한 중 하나 이상을 허용하는 워크스페이스만 표시됩니다.

“권한”

“읽기 · 페이지”나 “쓰기 · 링크”처럼 권한마다 체크 상자가 하나씩 있습니다. 내 역할이 허용하는 모든 권한이 미리 선택되어 있습니다. 내 역할이 허용하지 않는 권한은 흐리게 표시됩니다.

“거부” / “허용”

워크스페이스와 권한을 하나 이상 선택해야 “허용”이 활성화됩니다. 허용하면 자동으로 Claude로 돌아갑니다.

어떤 상자에 체크할지는 권한, 보안, 한도에서 설명합니다. 대부분은 미리 선택된 상태로 충분합니다.

#채팅에서 LinkHarbor 사용하기

1. 새 채팅을 시작합니다
2. 도구 또는 커넥터 메뉴에서 LinkHarbor가 켜져 있는지 확인합니다
3. 요청을 씁니다. 예: “내 LinkHarbor 페이지를 보여 주세요”
4. Claude가 물어보면 도구 호출을 확인합니다

게시, 링크 삭제, 공개 범위 변경 같은 작업은 영향이 큰 작업으로 표시됩니다. Claude는 보통 이런 작업을 실행하기 전에 물어봅니다.

#터미널의 Claude Code

Claude Code에서는 LinkHarbor를 HTTP 서버로 추가한 뒤 로그인합니다.

claude mcp add --transport http linkharbor https://dock.at-harbor.com/mcp

그런 다음 Claude Code에서 /mcp 명령을 실행하고 LinkHarbor를 고릅니다. 브라우저에서 위에 설명한 동의 페이지가 열립니다. 정확한 명령 문법은 새 Claude Code 버전에서 바뀔 수 있으니, 확실하지 않으면 claude mcp --help를 참고하세요.

#문제가 있을 때

“이 로그인 요청이 만료되었습니다. 앱에서 다시 시작하세요.”

“Connect”를 클릭한 뒤 결정하기까지 10분이 넘게 걸렸거나, 다른 LinkHarbor 계정에서 요청을 열었습니다. Claude에서 연결을 다시 시작하세요.

“요청한 권한을 허용하는 워크스페이스가 없습니다.”

어떤 워크스페이스에서도 내 역할이 요청한 권한을 포함하지 않습니다. 관리자나 소유자에게 알맞은 역할을 요청하세요.

Claude에 도구가 보이지 않음

해당 권한을 허용하지 않았습니다. “콜백 및 API” → “연결된 앱”에서 연결을 해제하고 다시 연결하세요.

플랜 오류

Creator Free에서 두 번째 페이지를 만드는 것처럼 작업이 플랜 한도를 넘습니다. 채팅에서도 대시보드와 똑같이 한도가 적용됩니다.