MCP 연결 문제 해결

BrainTube MCP 서버에 연결하는 데 문제가 있나요? 먼저 사용하는 클라이언트의 연결 방식을 확인하세요.

• Claude.ai와 Claude Desktop은 BrainTube를 사용자 지정 커넥터로 추가하고 BrainTube 계정으로 로그인해요. API 키는 필요 없어요.
• Cursor, Gemini CLI 등 다른 클라이언트는 설정 → API 키에서 만든 bt_ API 키를 X-BrainTube-Token 헤더에 담아 보내요.

엔드포인트는 모든 클라이언트에서 같아요: https://mcp.brain-tube.com/mcp. MCP는 무료 요금제를 포함한 모든 요금제에서 작동해요.

"Connection Refused" 또는 "Timeout"

• 인터넷 연결을 확인하세요
• URL이 정확히 https://mcp.brain-tube.com/mcp, 즉 /mcp로 끝나는 주소인지 확인하세요
• 브라우저에서 URL을 열어 보세요. 서버가 정상이면 간단한 BrainTube MCP 서버 페이지가 보여요

"Authentication Failed" 또는 "401 Unauthorized"

• Claude: Customize → Connectors(사용자 지정 → 커넥터)에서 BrainTube 커넥터를 삭제하고 다시 추가한 다음, 안내가 나오면 로그인하세요
• API 키 클라이언트: 키를 X-BrainTube-Token 헤더에 담아 보내세요(또는 Authorization: Bearer bt_... 형식으로). 키가 bt_로 시작하고 불필요한 공백이 없는지 확인하세요.
• 폐기했거나 잃어버린 키: 키는 만료되지 않으며, 잃어버린 키는 다시 볼 수 없어요. 설정 → API 키에서 새 키를 만드세요.

"No Tools Found"

• Claude Desktop에서는 개발자 설정 파일이 아니라 Customize → Connectors(사용자 지정 → 커넥터)에서 BrainTube를 추가하세요. 그 파일은 로컬 서버만 실행해요.
• Claude에서는 해당 채팅에 BrainTube 커넥터가 켜져 있는지 확인하세요
• Cursor나 Gemini CLI에서는 JSON 설정에 문법 오류가 없는지 확인하고, 변경한 뒤에는 클라이언트를 다시 시작하세요. Gemini CLI에는 url이 아니라 httpUrl이 필요해요.

"Empty Results"

• MCP 조회 결과가 나오려면 먼저 저장한 콘텐츠가 있어야 해요
• 새 항목은 검색할 수 있게 되기까지 30~60초가 걸려요
• 더 넓은 검색어를 써 보세요

지원하는 AI 도구