MCP 서버와 Skill

AI 어시스턴트에서 MyAltBox를 바로 검색할 수 있습니다. 제품의 대체 서비스 찾기, 오픈 소스·셀프 호스팅 옵션 비교, 새 제품 등록을 Claude, Cursor 등 MCP를 지원하는 클라이언트에서 할 수 있습니다.

MyAltBox는 두 가지 방법을 제공합니다.

• MCP 서버: https://myaltbox.com/api/mcp의 원격 서버로, AI 어시스턴트에 구조화된 도구를 제공합니다.
• Skill: Claude에게 언제, 어떻게 MyAltBox를 사용할지 알려 주는 짧은 설명 파일입니다. 단독으로도 쓸 수 있고, MCP 서버와 함께 쓰면 더 좋습니다.

도구

도구	기능	토큰
search_services	키워드 검색. 카테고리, 오픈 소스, 셀프 호스팅 가능 여부로 필터	불필요
get_service	제품 상세 정보: 설명, 라이선스, 가격, 플랫폼, 주요 기능, 상세 소개	불필요
get_alternatives	커뮤니티가 추천한 대체 서비스(투표순)	불필요
list_categories	전체 카테고리와 카테고리별 제품 수	불필요
submit_service	이름과 공식 웹사이트만으로 새 제품 등록	필요
add_alternative	한 제품을 다른 제품의 대체 서비스로 등록	필요

모든 도구에 locale(en, zh, ja, ko)을 지정할 수 있으며, 설명·카테고리·페이지 링크가 해당 언어로 반환됩니다.

MCP로 등록한 제품은 등록 페이지와 같은 규칙을 따릅니다. AI가 공식 웹사이트를 읽고 카테고리, 설명, 태그를 채우며, 관리자 검토 후 공개됩니다. 관리자가 아닌 계정은 하루 등록 수에 제한이 있습니다.

API 토큰

검색 도구는 계정 없이 사용할 수 있습니다. 제품을 등록하거나 대체 서비스를 추가하려면 아래에서 개인 API 토큰을 만들고 Authorization: Bearer <토큰> 형식으로 보내세요.

• 토큰은 한 번만 표시됩니다. 비밀번호처럼 보관하세요.
• 여기서 언제든지 토큰을 취소할 수 있으며, 취소하면 해당 토큰을 쓰는 클라이언트는 즉시 쓰기 권한을 잃습니다.

클라이언트 연결

Claude Code

# 검색 도구만 사용
claude mcp add --transport http myaltbox https://myaltbox.com/api/mcp

# 토큰과 함께, 모든 프로젝트에서 사용
claude mcp add --transport http myaltbox https://myaltbox.com/api/mcp \
  --scope user --header "Authorization: Bearer mab_내_토큰"

Claude Code에서 /mcp를 실행하면 연결 상태를 확인할 수 있습니다.

토큰을 저장소에 커밋하지 않고 프로젝트에서 공유하려면 .mcp.json에 추가하고 토큰은 환경 변수에서 읽어 오세요.

{
  "mcpServers": {
    "myaltbox": {
      "type": "http",
      "url": "https://myaltbox.com/api/mcp",
      "headers": { "Authorization": "Bearer ${MYALTBOX_TOKEN}" }
    }
  }
}

Claude Desktop과 claude.ai

「설정 → Connectors(커넥터)」에서 사용자 지정 커넥터를 추가하고 https://myaltbox.com/api/mcp를 입력하세요. 사용자 지정 커넥터는 아직 토큰 헤더를 보낼 수 없어 검색 도구만 사용할 수 있습니다.

Cursor

~/.cursor/mcp.json에 추가하세요.

{
  "mcpServers": {
    "myaltbox": {
      "url": "https://myaltbox.com/api/mcp",
      "headers": { "Authorization": "Bearer mab_내_토큰" }
    }
  }
}

VS Code

.vscode/mcp.json에 추가하세요.

{
  "servers": {
    "myaltbox": {
      "type": "http",
      "url": "https://myaltbox.com/api/mcp",
      "headers": { "Authorization": "Bearer mab_내_토큰" }
    }
  }
}

기타 클라이언트

Streamable HTTP 전송 방식을 지원하는 클라이언트라면 URL에 https://myaltbox.com/api/mcp를 입력해 사용할 수 있습니다. 검색 도구만 필요하다면 headers 부분은 빼세요.

Skill

Skill은 MyAltBox가 유용한 상황(예: "Notion을 대체할 수 있는 것은?", "셀프 호스팅 가능한 비밀번호 관리자")과 결과를 보여 주는 방법을 Claude에게 알려 줍니다. MCP 서버가 연결되어 있으면 MCP 도구를, 그렇지 않으면 공개 검색 API를 사용합니다.

Claude Code

mkdir -p ~/.claude/skills/myaltbox
curl -fsSL https://myaltbox.com/skills/myaltbox/SKILL.md -o ~/.claude/skills/myaltbox/SKILL.md

관련 질문이 나오면 Claude가 자동으로 불러오며, /myaltbox로 직접 실행할 수도 있습니다.

Claude Desktop과 claude.ai

myaltbox.zip을 내려받아 「설정 → Capabilities(기능) → Skills」에서 업로드하세요.

설치 전에 Skill 내용을 확인할 수 있습니다.

프롬프트 예시

• "셀프 호스팅할 수 있는 Notion의 오픈 소스 대체 서비스를 알려 줘"
• "MyAltBox로 Jellyfin과 Plex를 비교해 줘"
• "Linux와 Android에서 쓸 수 있는 무료 비밀번호 관리자를 찾아 줘"
• "Zed(https://zed.dev)를 Visual Studio Code의 대체 서비스로 MyAltBox에 추가해 줘"