MCP 서버

SocialGO MCP 서버란 무엇인가요?

SocialGO MCP 서버는 Model Context Protocol을 통해 패널을 AI 에이전트를 위한 도구 집합으로 노출합니다. 연결되면 어시스턴트가 서비스 카탈로그를 둘러보고, 주문을 넣고 추적하고, 리필을 요청하고, 잔액을 관리할 수 있습니다. 별도의 연결 코드는 필요 없습니다. 여러분의 대시보드가 쓰는 것과 동일한 API 위의 얇은 읽기·실행 레이어이므로, 에이전트는 여러분 계정의 한도와 가격 안에 머뭅니다.

Claude Desktop, Claude Code, Cursor, 그리고 MCP SDK로 만든 여러분만의 에이전트를 포함해, MCP를 지원하는 모든 클라이언트와 작동합니다.

여러분의 클라이언트에 추가하세요

서버는 @socialgo/mcp 패키지로 제공되며 npx를 통해 stdio로 실행되므로, 설치하거나 셀프 호스팅할 것이 없습니다. 다음 항목을 MCP 클라이언트 설정에 추가하세요:

{
  "mcpServers": {
    "socialgo": {
      "command": "npx",
      "args": ["-y", "@socialgo/mcp"],
      "env": {
        "SOCIALGO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code에서는 터미널에서 명령 하나로 등록할 수 있습니다:

claude mcp add socialgo -- npx @socialgo/mcp

추가한 뒤에는 위 명령이 가져올 수 있도록 환경에 SOCIALGO_API_KEY를 설정하는 것을 잊지 마세요.

인증

서버는 SOCIALGO_API_KEY라는 단일 환경 변수를 읽습니다. 계정 설정에서 키를 생성하고, 비밀로 유지하며, 소스 관리에 절대 커밋하지 마세요. 모든 도구 호출은 이 키로 인증·인가되며, 주문은 해당 계정 잔액으로 청구됩니다. 접근을 취소하려면 언제든 대시보드에서 키를 회전하세요.

핵심 도구

서버는 전체 주문 라이프사이클을 아우르는 작고 안정적인 도구 집합을 유지합니다:

• search_services — 플랫폼, 유형, 키워드로 서비스를 찾습니다. 모든 워크플로의 진입점입니다.
• get_service — 한 서비스의 전체 상세 정보를 가져옵니다: 단가, 최소/최대 수량, 지원 옵션.
• create_order — 대상 링크나 사용자명에 대해 한 서비스의 주문을 넣습니다.
• order_status — 주문의 실시간 상태, 진행률, 남은 수량을 확인합니다.
• balance — 현재 계정 잔액과 통화를 읽습니다.
• refill — 전달량 아래로 감소한 리필 대상 주문에 리필을 요청합니다.
• cancel — 아직 취소 가능한 주문을 취소하고 남은 자금을 회수합니다.
• list_orders — 최근 주문을 현재 상태와 함께 페이지 단위로 넘겨봅니다.
• add_funds — 계정에 잔액을 추가하는 충전 인텐트를 생성합니다.

"검색 후 실행" 설계

일반적인 SMM 패널은 수십 개 플랫폼에 걸쳐 수천 개의 서비스를 담습니다. 서비스마다 도구를 하나씩 등록하면 에이전트의 도구 목록이 넘치고, 컨텍스트 윈도를 폭발시키며, 모델을 더 느리고 부정확하게 만듭니다. SocialGO는 이를 완전히 피합니다.

대신 카탈로그는 단일 탐색 도구 뒤에 있습니다. 에이전트는 먼저 search_services를 호출해 수천 개의 옵션을 관련성 있는 소수로 좁히고, get_service로 하나를 살펴본 뒤, 그제야 create_order로 실행합니다. 동일한 아홉 개의 도구가 카탈로그가 아무리 커져도 전체를 아우르므로, 백엔드에 새 서비스를 추가해도 에이전트가 보는 도구 인터페이스는 결코 바뀌지 않습니다.

완전한 흐름은 다음과 같습니다:

1. search_services({ query: "instagram followers" })
   → returns a short list of matching services with ids + rates

2. get_service({ id: "<id>" })
   → confirms rate, min/max and options before spending

3. create_order({ id: "<id>", link: "<target>", quantity: 1000 })
   → returns an order id

4. order_status({ id: "<order_id>" })
   → poll until completed

이는 도구 목록을 작고 예측 가능하게 유지하고, 카탈로그가 수천 개의 서비스로 확장되게 하며, 에이전트에게 매번 신뢰할 수 있는 지출 전 확인 단계를 제공합니다.