WhatsApp Business Tools MCP: WhatsApp Business를 AI 에이전트에 연결하는 방법

2026년 9월 15일, Meta는 공식 WhatsApp Business Tools MCP 서버를 출시했습니다. 이 서버를 통해 Claude Code, Codex, ChatGPT 또는 Cursor 같은 AI 에이전트를 WhatsApp Business Platform에 연결할 수 있습니다. Developer Console, Business Manager, API 문서를 오가는 대신 에이전트에게 작업을 설명하면, 에이전트가 번호를 추가하고 메시지 템플릿을 만들며 웹훅을 설정하고 테스트 메시지를 보냅니다.

서버는 아직 베타 단계입니다. 접근 권한이 점진적으로 제공되고 있으며, 이번 릴리스는 대규모 프로덕션 메시지 전송이 아니라 개발과 테스트를 위한 것입니다. 아래에서는 클라이언트 네 가지의 사전 준비와 연결 절차를 설명합니다. 명령어와 설정은 2026년 9월 18일 Meta 공식 문서와 대조해 확인했습니다.

Ailoot 사용 방법은 문서에서 확인할 수 있습니다.

WhatsApp Business Tools MCP란 무엇인가요?#

MCP(Model Context Protocol)는 외부 시스템을 AI 에이전트에 연결하기 위한 개방형 표준입니다. 자세한 내용은 Claude Code용 MCP 서버: 바로 사용할 수 있는 통합 7가지에서 확인하세요. 설치 명령어가 포함된 검증된 연결 방법은 MCP 카탈로그에 있습니다.

이 서버가 나오기 전에는 WhatsApp 통합을 설정하려면 Developer Console을 열고, 앱을 만들고, 비즈니스를 연결하고, 전화번호를 추가하고, 코드를 받아 인증하고, 토큰을 생성하고, 웹훅을 설정하고, API 문서를 확인한 뒤에야 첫 번째 코드 줄을 작성할 수 있었습니다.

Meta는 서버의 취지를 다음과 같이 설명합니다(영어에서 번역):

현재 Meta에는 MCP 서버가 두 개 있어 혼동하기 쉽습니다. Meta Social Technologies MCP는 문서 검색, Graph API 엔드포인트 탐색, 앱 오류 진단을 위한 범용 개발자 도구입니다. WhatsApp Business Tools MCP는 WhatsApp 계정, 전화번호, 템플릿, 웹훅, 테스트 메시지 작업을 위한 서버입니다. 두 서버는 서로 보완하며, 필요하면 둘 다 연결할 수 있습니다.

연결한 뒤 에이전트가 정확히 무엇을 할 수 있나요?#

서버의 도구는 whatsapp_biz_ 접두사 아래에 그룹화되어 있습니다. 공식 문서에 따르면 다음과 같습니다.

• 개요: whatsapp_biz_businesses, whatsapp_biz_accounts, whatsapp_biz_phone_numbers—사용할 수 있는 비즈니스, 계정, 전화번호를 확인합니다.
• 전화번호 설정: whatsapp_biz_add_phone_number, whatsapp_biz_send_verification_code, whatsapp_biz_verify_phone_number, whatsapp_biz_register_phone_number.
• 템플릿: whatsapp_biz_list_templates, whatsapp_biz_get_template, whatsapp_biz_create_template, whatsapp_biz_update_template, whatsapp_biz_delete_template.
• 메시지: whatsapp_biz_send_message—24시간 대화 창 안에서는 자유 형식 텍스트를, 창이 닫힌 뒤에는 승인된 템플릿을 보냅니다. 전송 전에 에이전트가 수신자를 확인합니다.
• 웹훅: whatsapp_biz_configure_webhooks, whatsapp_biz_subscribe_webhook.
• 계정 설정: whatsapp_biz_configure_payments, whatsapp_biz_verify_business, whatsapp_biz_system_user_token—Cloud API를 직접 호출할 시스템 사용자 토큰을 만드는 링크입니다.

고객이 먼저 비즈니스에 메시지를 보내면 고객 서비스 대화 창이 열립니다. 24시간 동안 자유 형식 텍스트로 답장할 수 있고, 고객이 새 메시지를 보낼 때마다 창이 연장됩니다. 창이 닫힌 뒤에는 승인된 템플릿으로만 고객에게 연락할 수 있습니다. 에이전트는 이 규칙을 알고 있으며, 수신자가 대화 창 밖에 있으면 일반 텍스트 대신 템플릿을 보내도록 제안합니다.

서버에는 접근 제어 기능이 내장되어 있습니다. Meta 계정으로 로그인하고 특정 비즈니스를 선택하며, 토큰은 대화 기록에 포함되지 않습니다. 각 조회는 사용자의 컨텍스트에서 실행되고 호출은 기록됩니다. 변경을 수행하는 작업에는 인증된 사람이 필요하며, 서버 앱 키만으로는 충분하지 않습니다.

연결 전에 무엇을 확인해야 하나요?#

서버는 사용자를 대신해 사용자의 리소스만 다루므로 첫 호출 전에 다음을 확인하세요.

1. 관리자인 Meta 비즈니스가 있습니다(MANAGE 역할).
2. WhatsApp Business Messaging 시나리오가 활성화된 Meta 앱이 있습니다(구형 앱에서는 WhatsApp 제품). 또한 해당 앱의 관리자여야 합니다. 비즈니스 수준의 권한만으로는 충분하지 않습니다.
3. 해당 비즈니스가 WhatsApp Business Cloud API 약관에 동의했습니다. 약관에 동의하지 않으면 전화번호 등록과 메시지 전송이 차단됩니다.

Meta에 따르면 이용 약관, 결제 수단, 비즈니스 인증 관련 문제가 명확한 설명 없이 발생하는 경우가 많습니다. 에이전트는 이런 문제를 미리 확인하고 약관 동의, 결제 수단 지정, 비즈니스 인증 시작을 위한 직접 링크를 제공합니다.

Claude Code에 서버를 어떻게 연결하나요?#

Claude Code를 아직 설치하지 않았다면 공식 웹사이트에서 Claude Code 설치하기 가이드부터 확인하세요.

1. 서버 추가하기

   터미널에서 다음을 실행합니다.

   claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
   

   서버는 원격으로 제공되므로 로컬에 설치할 필요가 없습니다.

2. Meta를 통해 로그인하기

   Claude Code 세션에서 /mcp를 입력하고 whatsapp_business_tools를 선택합니다. Meta 계정에 로그인할 브라우저 창이 열립니다. 브라우저가 열리지 않으면 클라이언트에서 링크를 복사해 수동으로 여세요.

3. 권한 허용하기

   동의 화면에서 접근을 허용할 WhatsApp 관련 비즈니스와 앱을 선택합니다. 서버는 다음 세 가지 권한을 요청합니다. business_management(관리자인 비즈니스 찾기), whatsapp_business_management(계정, 전화번호, 템플릿, 웹훅 관리), whatsapp_business_messaging(사용자 번호로 메시지 전송).

4. 연결 확인하기

   Claude Code를 다시 시작하고 /mcp를 통해 다시 로그인한 다음, whatsapp_business_tools 서버에서 어떤 도구를 볼 수 있는지 에이전트에게 물어봅니다. 그런 다음 안전한 조회를 실행합니다. “내가 관리할 수 있는 비즈니스를 나열해”라고 요청하면 에이전트가 whatsapp_biz_businesses를 호출합니다. 도구가 보이지 않거나 로그인 오류가 발생하면 서버 주소를 확인하고 다시 로그인하세요.

OAuth 로그인은 클라이언트 실행에 연결되어 있습니다. Claude Code를 다시 시작한 뒤에는 다시 로그인해야 합니다. facebook.com의 설정에서 “비즈니스 통합”으로 이동하면 언제든지 접근 권한을 취소할 수 있습니다.

Codex, ChatGPT, Claude Desktop은 어떻게 연결하나요?#

Codex App. 설정(왼쪽 아래의 톱니바퀴)을 열고 MCP Servers로 이동한 다음 Add servers를 선택합니다. Streamable HTTP를 선택하고 다음을 입력합니다.

• 이름: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• 인증: OAuth

Authenticate를 클릭하고 브라우저에서 로그인합니다.

ChatGPT. 설정, 플러그인, Browse plugins, 오른쪽 위의 “+” 아이콘으로 이동합니다. 이름과 동일한 URL을 입력하고 인증 유형으로 OAuth를 선택합니다.

Claude Desktop. 설정, 커넥터, 사용자 지정 커넥터 추가로 이동합니다. 이름: WhatsApp Business Tools; URL: 동일한 서버 주소.

어떤 클라이언트에서든 추가한 뒤에는 동일한 확인 절차를 따르면 됩니다. 다시 시작하고, 다시 로그인하고, 도구 목록을 확인한 다음 비즈니스 목록을 안전하게 조회합니다.

첫 세션에서는 어떤 일이 일어나나요? 비즈니스 목록 확인부터 테스트 메시지까지#

서버를 연결한 뒤의 일반적인 첫 세션은 다음과 같습니다.

1. “내가 관리하는 비즈니스를 나열해”—에이전트가 whatsapp_biz_businesses를 호출하고 사용자는 필요한 비즈니스를 선택합니다.
2. “이 비즈니스의 WhatsApp 계정과 전화번호를 보여줘”—whatsapp_biz_accounts와 whatsapp_biz_phone_numbers를 호출해 상태를 표시합니다.
3. “내 테스트 전화번호를 계정에 추가해”—whatsapp_biz_add_phone_number를 호출합니다.
4. “SMS로 인증 코드를 보내”—whatsapp_biz_send_verification_code를 호출합니다. 코드가 사용자의 전화로 도착합니다.
5. “코드 123456으로 번호를 인증해”—whatsapp_biz_verify_phone_number를 호출한 다음 whatsapp_biz_register_phone_number로 등록합니다.
6. “주문 알림을 받을 사람들이 선호하는 언어로 order_update 템플릿을 만들어”—whatsapp_biz_create_template을 호출합니다. 에이전트가 승인 상태 링크를 제공합니다.
7. “내 번호로 테스트 메시지를 보내”—whatsapp_biz_send_message를 호출하며, 전송 전에 에이전트가 수신자를 확인합니다.
8. “https://example.com/webhook에 웹훅을 설정해”—whatsapp_biz_configure_webhooks를 호출하고 whatsapp_biz_subscribe_webhook으로 구독합니다.

그다음부터 고객의 수신 메시지가 지정한 주소로 도착합니다. 일반적으로 CRM, 고객 지원 서비스 또는 봇이 해당 주소에서 메시지를 가져옵니다. 해당 주소에서 메시지를 처리하는 기능은 별도로 구축해야 합니다. 서버는 설정만 처리합니다.

베타 버전에는 어떤 한계가 있나요?#

서버의 한계는 네 가지입니다.

베타 상태. Meta는 인터페이스와 도구 구성이 변경될 수 있으며 접근 권한을 점진적으로 배포하고 있다고 설명합니다. 아직 서버에 연결할 수 없다면 사용자에게 접근 권한이 제공되지 않았을 수 있습니다.

용도. 이번 릴리스는 개발과 테스트용이며 대량 프로덕션 전송을 위한 것이 아닙니다. 프로덕션 메시지를 보내려면 Cloud API와 완전히 통합해야 합니다. 예를 들어 시스템 사용자 토큰을 사용할 수 있으며, 토큰 링크는 whatsapp_biz_system_user_token 도구가 제공합니다.

한도. 각 도구의 요청은 사용자별로 제한됩니다. 한도를 초과하면 도구가 한도 오류를 반환하므로 잠시 기다렸다가 다시 시도하세요.

24시간 창 규칙. 고객 대화 창이 닫힌 뒤에는 승인된 템플릿만 보낼 수 있습니다.

비즈니스에 왜 중요한가요?#

소규모 비즈니스의 일반적인 사례를 생각해 보세요. 고객이 WhatsApp으로 메시지를 보내고, 빠르게 답장하고 주문 상태 알림도 보내고 싶습니다. 이전에는 초기 설정을 위해 여러 Meta 대시보드에서 직접 작업하거나 개발자를 고용해야 했습니다. 이제는 에이전트와 대화하며 이 부분을 완료할 수 있습니다. 수신 메시지를 사용자의 주소에서 처리하는 기능은 여전히 별도로 구축해야 합니다. 웹훅을 설정한 다음 진행할 작업입니다.

통합이 이미 실행 중인 경우에도 이 서버가 유용합니다. 메시지 템플릿은 새 프로모션이나 새 알림 문구처럼 정기적인 업데이트가 필요합니다. 서버를 이용하면 에이전트가 템플릿을 만들거나 수정하고 승인 상태를 보여 주므로 대시보드로 이동할 필요가 없습니다.

에이전트가 외부 시스템에 연결되어 사용자의 설명에 따라 작업하는 비슷한 접근 방식은 MCP를 통해 NotebookLM을 Claude Code에 연결하는 방법 가이드에서 문서와 함께 소개합니다.

다음에는 무엇을 하면 되나요?#

서버가 발표된 지 3일이 지났습니다. 명령어 하나로 시작해 Meta에 로그인한 다음 에이전트에게 비즈니스 목록을 요청할 수 있습니다. 이후에는 필요에 따라 전화번호, 템플릿, 웹훅, 테스트 메시지를 설정합니다.

외부 시스템에 에이전트를 연결하는 다른 방법은 Claude Code용 MCP 서버 모음에서 확인할 수 있습니다. 다양한 작업에 사용할 수 있는 작동하는 통합이 7개 더 있습니다.

Ailoot을 알아보세요.