MCP를 통해 AI 에이전트를 BroadNet에 연결하세요.

MCP 서버란 무엇인가

Model Context Protocol(MCP)은 AI 어시스턴트가 외부 도구를 발견하고 호출할 수 있도록 하는 개방형 표준입니다. BroadNet MCP 서버는 원격 MCP 서버입니다. 고객님의 클라이언트가 HTTPS를 통해 서버에 연결하면, 서버가 제공하는 도구 목록을 나열하고 고객님을 대신하여 해당 도구들을 호출합니다.

이 도구들은 API 레퍼런스 및 OpenAPI 명세에 문서화된 동일한 BroadNet API에 매핑됩니다. 메시지 전송, WhatsApp 템플릿 활용, 전송 결과 보고 확인 등이 포함됩니다. 에이전트는 사용자가 부여한 토큰의 권한에 따라 작동하며, 이는 사용자의 코드가 작동하는 방식과 정확히 일치합니다.

두 가지 MCP 서버: 지식 및 메시징

BroadNet은 두 개의 MCP 서버를 운영합니다. 이 페이지에 설명된 메시징 서버는 고객의 계정에서 작동합니다. 지식 서버는 공개되어 있어, 에이전트가 로그인 없이도 BroadNet의 커버리지, 발신자 ID 규칙, 게시된 요금 목록, 규정 및 회사 정보에 대해 문의할 수 있습니다.

터미널에서 지식 서버를 테스트해 보세요: 핸드셰이크를 초기화한 다음, 도구 호출을 수행합니다.

curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"curl","version":"1.0"}}}'

curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"sender_id_rules","arguments":{"country":"ae"}}}'

엔드포인트 및 인증

모든 계정에는 하나의 엔드포인트가 있습니다: https://mcp.broadnet.me/mcp. 모든 요청은 Authorization 헤더에 BroadNet 토큰을 포함해야 합니다.

토큰은 BroadNet 계정에서 발급받을 수 있습니다. 데모에서는 BroadAdmin 포털의 Integrations → MCP Integration 메뉴에서 “Get temporary key”를 통해 생성됩니다. 포털 안내에 따르면 영구 키는 계정 관리자 또는 마스터 계정에서 발급합니다.

헤더가 없는 요청은 프로토콜 수준에서 거부됩니다. 인증되지 않은 초기화 호출에 대한 서버의 실제 응답은 다음과 같습니다:

event: message
data: {"jsonrpc":"2.0","id":1,"error":{"code":-32001,
  "message":"Authorization bearer token is required. Connect with an
  'Authorization: Bearer <BroadNet token>' header."}}

MCP 클라이언트 연결

대부분의 MCP 클라이언트는 서버 URL과 요청 헤더를 포함한 JSON 설정을 사용합니다. 일반적인 입력 예시는 다음과 같습니다:

{
  "mcpServers": {
    "broadnet": {
      "type": "http",
      "url": "https://mcp.broadnet.me/mcp",
      "headers": {
        "Authorization": "Bearer ${BROADNET_TOKEN}"
      }
    }
  }
}

클라이언트 없이 연결을 테스트하려면, 직접 MCP 초기화 요청을 보내세요:

curl -X POST https://mcp.broadnet.me/mcp \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"curl","version":"1.0"}}}'

데모 시연 내용

제품 팀의 녹화 영상을 통해 MCP 클라이언트로 Cursor를 사용하여 전체 프로세스를 5단계로 확인하실 수 있습니다:

1. 1
   로그인

   BroadNet 계정으로 BroadAdmin 포털에 로그인하세요.

2. 2
   키 및 설정 가져오기

   Integrations → MCP Integration으로 이동하여 임시 키를 생성하고 준비된 클라이언트 설정을 복사하세요.

3. 3
   클라이언트에 서버 추가

   MCP 클라이언트에서 새로운 MCP 서버를 추가하고 mcp.json에 설정을 붙여넣으세요. Bearer 헤더를 포함한 URL https://mcp.broadnet.me/mcp을 사용합니다.

4. 4
   도구 검토

   클라이언트가 연결하여 BroadNet 도구 목록을 확인하며, 각 도구는 개별적으로 활성화 또는 비활성화할 수 있습니다.

5. 5
   일상 언어로 질문하기

   사용자가 에이전트에게 특정 번호로 WhatsApp 메시지를 보내도록 요청합니다. 에이전트는 WhatsApp 전송 도구를 선택하고, API는 메시지 수락을 의미하는 HTTP 200 응답을 반환하며, 메시지는 비즈니스 계정에서 WhatsApp으로 전달됩니다.

기록에 따르면 고객은 380개의 BroadNet 도구를 보고했으며, 여기에는 send_message, post_sms_send, post_whatsapp_message_send, get_whatsapp_template_list, post_whatsapp_template_send, post_rcs_message_send, post_telegram_message_send, post_instagram_message_send, post_messenger_message_send, post_push_message_send 및 get_report_delivery이 포함됩니다. 정확한 목록은 서버 버전과 귀하의 계정에 따라 달라집니다.

동일한 녹음의 내레이션 버전이 개요 카드를 추가합니다: 하나의 MCP 엔드포인트와 모든 에이전트에게 동일하게 적용되는 복사 및 붙여넣기 단계로 구성됩니다.

보안 유의사항

• 토큰은 발송 인증 정보입니다

  이 키를 보유한 누구든 귀하의 계정으로 메시지를 보낼 수 있습니다. 비밀번호처럼 관리해야 하며, 공유 파일이나 커밋된 파일에 절대 저장하지 마세요.

• 테스트용 임시 키 사용 권장

  테스트 단계에서는 임시 키를 사용하고, 운영 에이전트용 영구 키는 계정 관리자에게 요청하세요.

• 필요한 도구만 활성화하세요

  MCP 고객은 개별 도구를 선택적으로 끌 수 있습니다. 문자만 발송하는 에이전트에게는 템플릿, 온보딩 또는 계정 도구가 필요하지 않습니다.

• 사람이 개입하는 프로세스 유지

  AI 에이전트가 자연어 지침에 따라 동작합니다. 특히 다수의 수신자에게 메시지를 보내는 도구를 사용하기 전에는 클라이언트가 확인을 요청하도록 설정하세요.

• 유출된 토큰 취소

  토큰이 노출된 경우, 계정 관리자 또는 BroadNet 지원팀에 연락하여 토큰을 폐기하고 새 토큰을 발급받으세요.

관련 항목

질문