MCP 커넥터로 MonstarX에 도구 주기

Q: 대화 모드에서는 왜 MonstarX가 도구를 쓸 수 없나요?

도구는 다른 시스템의 내용을 바꿀 수 있으므로, MonstarX는 만들기 모드에서만 도구를 실행합니다. 대화 모드와 계획 모드에서도 서버에 어떤 도구가 있는지는 볼 수 있습니다.

Q: 앱에서도 이 MCP 서버를 쓸 수 있나요?

아니요. MCP 커넥터는 MonstarX 전용입니다. 앱에 서비스를 연결하려면 커넥터를 쓰거나, 백엔드 → 시크릿에 키를 넣고 MonstarX에 연동을 요청하세요. 날씨, 교통, 등록 정보 같은 국가별 실시간 공공 데이터는 MonstarX가 호스팅하는 국가 데이터를 쓰세요.

핵심 요약백엔드 → 클라우드 → 커넥터 → MCP에서 이름과 HTTPS 주소로 원격 MCP 서버를 추가하거나, JSON 구성을 붙여 넣어 여러 서버를 한 번에 추가하세요. MonstarX가 연결을 확인하고 서버의 도구 목록을 불러온 뒤, 그 프로젝트의 만들기 모드에서 도구를 쓸 수 있습니다. 프로젝트당 최대 32개 서버까지 연결할 수 있습니다.

MCP(Model Context Protocol)는 AI 도구끼리 서로 기능을 제공하는 공통 방식입니다. MCP 서버는 문서 검색, 회사 시스템 조회, 작업 실행 같은 도구 묶음을 제공하는 서비스입니다. 요즘은 많은 제품이 MCP 서버를 공개합니다.

프로젝트에 MCP 서버를 연결하면 MonstarX가 그 앱을 작업하는 동안 서버의 도구를 쓸 수 있습니다. 예를 들어 문서 서버를 연결하고 “결제 서비스 문서를 확인해서 권장 방식대로 환불 흐름을 만들어 주세요”라고 요청할 수 있습니다.

시작하기 전에

서버의 공개 HTTPS 주소가 필요합니다. 제공업체의 문서에서 찾을 수 있으며, 보통 /mcp나 /sse로 끝납니다.
서버에 로그인이 필요하다면 제공업체에서 액세스 토큰이나 API 키를 받으세요.

MCP 서버는 어떻게 추가하나요?

프로젝트를 열고 상단 바에서 백엔드를 클릭한 다음 클라우드를 클릭하세요.
커넥터에서 MCP 카드를 찾아 서버 추가를 클릭하세요.
양식을 채우세요.
- 서버 이름: “문서 검색”처럼 알아보기 쉬운 이름이면 됩니다.
- 서버 URL: 서버의 HTTPS 주소입니다.
- 연결 유형: 요즘 서버는 Streamable HTTP를, 제공업체가 SSE 주소를 줬다면 이전 방식 SSE를 고르세요.
- Bearer 토큰(선택 사항): 서버에 액세스 토큰이 필요하면 넣으세요.
- 맞춤 헤더(JSON, 선택 사항): { "X-Api-Key": "…" }처럼 키를 전용 헤더로 받는 서버에 씁니다.
연결하고 도구 확인을 클릭하세요. MonstarX가 서버에 연결해 도구 목록을 불러온 뒤에야 저장합니다. 연결하지 못하면 아무것도 저장하지 않고 무엇을 확인해야 하는지 알려 줍니다.

여러 서버를 한 번에 추가할 수 있나요?

네, 다른 도구에서 쓰던 MCP 구성이 있다면 가능합니다. 서버 추가 대신 JSON 가져오기를 클릭하고, mcpServers 객체를 붙여 넣은 뒤 연결하고 도구 확인을 클릭하세요.

{
  "mcpServers": {
    "documentation": {
      "url": "https://mcp.example.com/mcp"
    },
    "workspace": {
      "type": "http",
      "url": "https://tools.example.org/mcp",
      "headers": { "Authorization": "Bearer YOUR_ACCESS_TOKEN" }
    },
    "legacy": {
      "type": "sse",
      "url": "https://legacy.example.net/sse"
    }
  }
}

MonstarX는 어느 하나라도 저장하기 전에 모든 서버를 확인합니다. 서버 이름은 모두 달라야 합니다. 내 컴퓨터에서 프로그램을 실행하는 서버(url 대신 command가 있는 서버)는 가져올 수 없습니다.

JSON 가져오기 양식. MCP 구성 입력란, 명령 기반 서버는 지원하지 않는다는 안내, 연결하고 도구 확인과 취소 버튼이 있습니다

MonstarX는 도구를 어떻게 쓰나요?

서버가 연결되고 활성화되면 MonstarX는 서버의 도구와 그 도구를 쓸 때를 압니다. 평소처럼 대화창에서 요청하고, 도움이 된다면 “문서 검색 서버로 웹훅이 어떻게 작동하는지 확인해 주세요”처럼 서버 이름을 언급하세요.

만들기 모드에서는 도구를 살펴보고 쓸 수 있습니다.
계획 모드와 대화 모드에서는 어떤 도구가 있는지 볼 수만 있고 쓸 수는 없습니다.
두 서버에 이름이 같은 도구가 있어도 MonstarX가 구분합니다.
가져온 앱에서도 작동합니다.

연결된 서버는 어떻게 관리하나요?

MCP 카드의 각 서버에는 도구 개수와 다음 버튼이 표시됩니다.

도구 개수를 클릭하면 서버가 제공하는 도구를 볼 수 있습니다.
연결 확인은 다시 연결해 도구 목록을 새로고침합니다. 제공업체가 도구를 추가했을 때 쓰세요.
비활성화를 클릭하면 이미 실행 중인 요청에서도 MonstarX가 그 서버를 쓰지 않습니다. 활성화를 클릭하면 다시 켜집니다.
제거는 확인을 거친 뒤 서버와 저장된 자격 증명을 삭제합니다.

지원하지 않는 것은 무엇인가요?

내 컴퓨터에서 실행되는 서버(명령으로 시작하는 서버), 사설 네트워크나 localhost에 있는 서버. 주소는 공개 HTTPS 주소여야 합니다.
팝업 창에서 로그인하는 방식(대화형 OAuth). 대신 제공업체에서 토큰을 받아 Bearer 토큰으로 붙여 넣으세요.
만료되는 토큰의 자동 갱신. 토큰이 만료되면 서버를 제거하고 새 토큰으로 다시 추가하세요.
MCP 리소스와 프롬프트, 그리고 MonstarX에 되묻는 기능이 필요한 서버(sampling, elicitation). 도구만 사용합니다.

알아 두면 좋은 점

프로젝트당 최대 32개 서버까지 연결할 수 있습니다.
자격 증명은 비밀로 유지됩니다. 주소와 토큰, 헤더는 모두 암호화됩니다. 대화창, 앱 코드, 게시된 앱 어디에도 나타나지 않습니다.
프로젝트 하나에서만 쓰입니다. 서버는 추가한 프로젝트에만 속하며, 그 프로젝트의 소유자만 추가할 수 있습니다.

자주 묻는 질문

MCP 서버 주소는 어디에서 찾나요?

제공업체의 공식 문서에서 찾을 수 있습니다. 보통 ‘MCP’나 ‘AI 연동’ 항목에 있습니다. HTTPS 주소이며 /mcp로 끝나는 경우가 많습니다.

대화 모드에서는 왜 MonstarX가 도구를 쓸 수 없나요?

도구는 다른 시스템의 내용을 바꿀 수 있으므로, MonstarX는 만들기 모드에서만 도구를 실행합니다. 대화 모드와 계획 모드에서도 서버에 어떤 도구가 있는지는 볼 수 있습니다.

서버에 로그인이 필요합니다. 어떻게 해야 하나요?

제공업체에 액세스 토큰이나 API 키를 요청해 <strong>Bearer 토큰(선택 사항)</strong>에 붙여 넣으세요. 제공업체가 다른 헤더 이름을 쓰라고 하면 맞춤 헤더에 넣으세요.

토큰이 만료되었습니다. 어떻게 바꾸나요?

서버를 제거하고 새 토큰으로 다시 추가하세요. MonstarX는 토큰을 자동으로 갱신하지 않습니다.

앱에서도 이 MCP 서버를 쓸 수 있나요?

아니요. MCP 커넥터는 MonstarX 전용입니다. 앱에 서비스를 연결하려면 커넥터를 쓰거나, 백엔드 → 시크릿에 키를 넣고 MonstarX에 연동을 요청하세요. 날씨, 교통, 등록 정보 같은 국가별 실시간 공공 데이터는 MonstarX가 호스팅하는 국가 데이터를 쓰세요.