Jober (자버) KakaoTalk AlimTalk

Jober（자버）KakaoTalk AlimTalk MCP 服务（KakaoTalk AlimTalk MCP）

자버 AlimTalk MCP 服务是一个连接工具，让你可以通过对话，在 AI 工具中发送 KakaoTalk AlimTalk、电子邮件和短信。 将 자버 连接到 Claude、ChatGPT、Cursor、VS Code，然后告诉它要发送的内容和收件人。

“把这条短信内容改成 AlimTalk，发送给客户名单。”

AI 会按发送 AlimTalk 或电子邮件的要求准备消息。你可以在按钮中添加自己的网页或问卷链接、登记收件人、发送消息，之后还能通过对话查看送达、阅读和回复结果。

即使你不熟悉 MCP 也没关系。你可以把它理解为一种连接方式，让 AI 工具能够使用 자버 的功能。

KakaoTalk AlimTalk 可以通过电话号码发送，无需收件人添加频道好友。无需按月订阅，采用预付费方式，按需充值并按发送条数扣费。发送费用约为每条 50 韩元。短信（SMS）只能发送信息类通知，且需先在 자버 设置中启用短信发送。

Jober（자버，jober.io）是一项韩国消息服务，支持 KakaoTalk AlimTalk、电子邮件和短信。它不是现场服务软件 Jobber。

第一次使用？

1. 注册 자버 并体验服务

如果你还没有 자버 账号，请前往注册 자버自行注册（AI 工具无法代你创建账号）。

注册后，你可以使用价值 500 韩元的赠金发送约 10 条消息。注册后即可使用电子邮件和 AlimTalk。

注册赠金和体验额度是两回事。

关联 Kakao 频道之前，电子邮件和 AlimTalk 合计最多可发送 10 条体验消息。即使充值，体验额度也不会增加。

要发送超过 10 条消息，必须同时关联 Kakao 频道并充值。

2. 将 자버 连接到你使用的 AI 工具

有两种连接方式。如果你使用的 AI 工具支持远程 MCP，使用 자버 账号登录即可连接，无需安装，操作更简单。

连接方式	开始使用
免安装连接（OAuth）	在 AI 工具的连接器或 MCP 设置中添加 https://api.jober.io/mcp。在打开的页面中登录 자버 并允许连接即可（直接连接远程 URL）。
在自己的电脑上通过软件包连接（API 密钥）	将 npx -y @joberhr/jober-mcp 注册为 MCP 服务启动命令。在设置中的 JOBER_API_KEY 填入 자버 个人 API 密钥即可（安装）。

如果通过软件包连接，请前往设置 > AI 工具集成申请个人 API 密钥（jbr_live_...）。将密钥填入 JOBER_API_KEY 后，重启 MCP 服务即可。

各 AI 工具的设置方法，请参阅下文的安装和자버 开发者文档：MCP 服务。

3. 连接成功后，告诉 AI 要发送什么

准备好要发送的消息和客户名单，然后让 AI 完成你需要的工作。

“我想把这段内容通过 AlimTalk 发给客户。请在按钮中添加这个问卷链接。”

发送后，你也可以要求查看结果，例如“告诉我送达情况”。

没有 API 密钥也可以先获取帮助

你可以先不提供 API 密钥，直接运行本地软件包。如果密钥缺失或格式不正确，程序不会退出，而是以仅提供引导的模式运行。

此时只会显示一个 get_started 工具。该工具会介绍注册、申请个人 API 密钥以及设置连接的方法。设置好密钥并重启 MCP 服务后，即可使用发送所需的工具。详情请参阅仅提供引导的模式（未设置密钥时）。

英文摘要

@joberhr/jober-mcp 是适用于 Jober 的 KakaoTalk AlimTalk（카카오 알림톡）MCP 服务。Jober 是一项韩国消息服务。 它将 Claude、ChatGPT、Cursor 和 VS Code 等 AI 工具作为本地（stdio）MCP 服务连接到 Jober。它可以将短信转换为 KakaoTalk AlimTalk 或电子邮件营销活动，附加问卷落地页，导入收件人，发送或安排营销活动，并报告送达、阅读和回复结果。它本身不包含任何业务逻辑：它使用个人 API 密钥（jbr_live_）作为 Authorization: Bearer <JOBER_API_KEY>，将 tools/list 和 tools/call 代理到远程 Jober MCP 服务 （https://api.jober.io/mcp，Streamable HTTP）。公司 API 密钥（jbr_co_）用于服务端集成（send API、免费发送 REST），不能用于 MCP。

• 第一次使用 Jober？ 请在 https://jober.io/start/ai?src=mcp&client=local 自行注册（没有创建账户的 API），然后创建个人 API 密钥。
• 仅指南模式：如果缺少 JOBER_API_KEY、密钥格式错误或属于公司密钥，服务不会退出，而是仅提供一个 get_started 工具，返回注册链接、创建密钥的位置、设置方法以及远程 OAuth 替代方案 （无需密钥即可从 <JOBER_API_BASE>/ai-agent/v2/public/getting-started?client=local 获取，并附带离线副本）。 设置密钥并重启服务，即可使用营销活动工具。无效的 JOBER_API_BASE 仍会导致服务以代码 1 退出。
• 渠道：可通过 draft_send 的 channel 使用 EMAIL（注册后即可使用，预付余额）和 KAKAO（默认）， 以及仅用于信息类消息的 SMS（每条 50 KRW，必须在 Jober 中启用，即 channels[SMS]；广告会被拒绝，并返回 J_41_21_1_10）。省略 channel 时，由服务自动决定（channelDecision）。在 get_send_readiness 中检查 channels[] 和 onboarding.nextStep。 连接 Kakao 渠道之前，邮件和 AlimTalk 共用 10 条的试用额度，充值不会提高额度；连接渠道并充值后即可发送更多消息（请查看 channels[EMAIL].quota；向 get_send_readiness 传入 targets，以获取 channels[].capacity）。 余额不足时会返回 J_41_23_1_14 和 data.prepaidUrl。
• 免打扰时段：仅在 KST 21:00-08:00 发送的广告类 Alimtalk 会自动安排在请求时间之后第一个 KST 08:00 发送；信息类 Alimtalk 和所有邮件均会立即发送。Email 的 prepare_send 始终包含 EMAIL_NIGHT_ALLOWED 提示。请查看 get_send_readiness 中的 quietHours.channels。
• 服务名称：MCP 服务标题为 Jober (자버) 알림톡·이메일 AI 에이전트（与远程服务相同）；服务名称为 jober-mcp。
• API 密钥：在 https://jober.io/settings/integrations 创建（仅显示一次；可随时在此撤销）。
• 安装：运行 claude mcp add jober -e JOBER_API_KEY=jbr_live_xxxxxxxx -- npx -y @joberhr/jober-mcp，或在 Claude Desktop、Cursor 或 VS Code 中使用 npx -y @joberhr/jober-mcp 命令，并设置 JOBER_API_KEY 环境变量（请参阅下文的 설치）。
• 远程（OAuth）：支持远程 MCP 的客户端可直接连接 https://api.jober.io/mcp，并使用 OAuth 2.1（PKCE）登录。
• 环境变量：JOBER_API_KEY（营销活动工具必需；未设置时进入仅指南模式）、JOBER_API_BASE（默认值为 https://api.jober.io；仅允许 https，localhost 除外）。
• 工具：下文列出的 22 个工具（包括在正式发送前向一位测试收件人发送测试消息的 send_test，以及按用户要求更改落地页的 edit_page），其中包括 get_send_readiness、draft_send（一次调用即可转换内容、附加链接、创建落地页并检查收件人）、answer_questions 和 set_direct_link（在 AlimTalk 按钮中使用你自己的 URL，即“消息+链接”）。
• 指南：结果中包含 guide（stage、要向用户提出的 questions，以及带预填参数的 nextActions）。请遵循指南，并使用 answer_questions 回答所有问题。
• Kakao 渠道：建议连接 Kakao 渠道，但并非必需。未连接时，消息会通过 Jober 的共享 渠道发送，且受与 Web 应用相同的限制约束（请查看 get_send_readiness 中的 limits）；外部链接或广告优惠券消息在每个空间内的收件人总数上限为 3 人，所有发送次数累计计算（返回 J_41_23_1_13；邮件不受影响）。没有链接按钮模板的目标地址会被拒绝，返回 J_41_23_4_4 （NO_BUTTON_TEMPLATE）。如果渠道状态查询暂时失败，prepare_send/submit_send 会返回 工具错误 J_41_23_2_3（HTTP 200，且 result.isError: true；REST API 则返回 HTTP 503），且不包含 needsPrepare：请稍后重试 （对于 submit_send，请使用相同的确认哈希；无论重用相同的幂等键还是使用新的幂等键，均可安全重试）。
• 营销活动状态：每次读取时都会计算 status（10 种状态：DRAFT、NEEDS_INPUT、READY、PREPARED、BLOCKED、SCHEDULED、 SENDING、SENT、CANCELED、FAILED）。pendingOperation.status 仅为 SUBMITTING；不再返回 UNKNOWN。
• 发送安全：先调用 prepare_send，再调用 submit_send，需提供确认哈希和必需的幂等键（无需单独的人工审批步骤）；收件人 仅限已在服务端确认的对象；遵循与 Web 应用相同的服务端策略（垃圾消息拦截、退订文案、 广告同意、各渠道的免打扰时段（仅在 KST 21:00 至 08:00 之间准备的广告类 Alimtalk 会自动改期至请求时间之后第一个 KST 08:00 发送，无需询问；信息类 Alimtalk 和所有邮件（包括广告邮件）均会立即发送；请查看 quietHours.channels），并在 summary.adjustments 中报告相应调整；默认启用退订链接（仅信息类营销活动可关闭）；1000 个字符的限制、余额和发送限制）、即时管理员通知以及可取消的定时发送。代理不会自动重试失败的调用。

此软件包的作用

此软件包是一个本地（stdio）MCP 服务。它不包含自己的逻辑，只会将请求原样转发到 Jober 远程 MCP 服务（https://api.jober.io/mcp，Streamable HTTP），包括 tools/list·tools/call，并使用个人 API 密钥（Authorization: Bearer <JOBER_API_KEY>）进行身份验证。 如果客户端直接支持远程 MCP，也可以不使用此软件包，直接连接远程 URL。 MCP 客户端中显示的服务名称（title）与远程服务相同，为 Jober (자버) 알림톡·이메일 AI 에이전트，服务名称（name）为 jober-mcp。

可以做什么

• 发送前检查（get_send_readiness）：Kakao 渠道关联情况、剩余发送限额（limits）及说明（notices）、可用功能、是否处于夜间时段、权限
• 一次性根据原文创建草稿（draft_send）：一次完成内容转换、添加自己的链接、开始创建页面、检查名单；通过 answer_questions 一次性回答问题
• 将短信（SMS）原文转换为 AlimTalk 活动草稿（判断信息性／广告性、推荐格式、询问缺失值）。如果原文为广告内容，只在前面保留已收到优惠的说明，并将宣传内容放在按钮后
• 修改活动（发送名称、变量值、格式、更改信息性通知中的退订链接设置）
• 为按钮添加自己的链接（消息 + 链接）、创建问卷落地页或选择现有问卷
• 预览并登记联系人列表（电话号码规范化、去重、关联个性化变量）
• 准备发送（目标人数、预计费用、预览、生成确认值）后发送或预约。如果在夜间准备发送广告性 AlimTalk，则不会询问，而是自动预约到预约时间之后的第一个 08:00（韩国时间）；信息性 AlimTalk 和电子邮件即使在夜间也会立即发送
• 取消预约发送、查询发送结果（送达·已查看·回复）、准备向未查看·未回复者再次发送通知
• 电子邮件活动：在 draft_send 中加入 channel: "EMAIL"，即可通过相同流程（草稿 → 问题 → 准备 → 发送 → 结果）发送电子邮件。对于广告性电子邮件，服务端会添加标题中的 (광고)、退订信息和发件人信息。对于信息性电子邮件，不会添加 (광고) 和发件人信息，只会默认添加退订链接

可发送的渠道

渠道	channel 值	状态	注意事项
电子邮件	EMAIL	可用	注册后即可发送（扣除预付余额，使用注册奖励 500 韩元约可发送 10 封）。关联 Kakao 渠道之前，电子邮件和 AlimTalk 共用 10 次体验额度；充值也不会增加额度，若要超过 10 次，必须同时关联 Kakao 渠道并充值（剩余数量见 channels[EMAIL].quota）。发送前会进行垃圾邮件检查。夜间也会直接发送，不会自动预约（建议在白天发送）。收件人由联系人中的电子邮件字段（recipients.columnMap.email）决定。如果是广告性邮件，服务端会强制在标题前加上 (광고)，并加入退订信息、发件人名称和联系方式（若缺少，guide 会询问 email.sender）
Kakao AlimTalk	KAKAO（默认值）	可用	关联渠道之前可体验 10 次（与电子邮件合计 10 次）；外部链接·广告优惠券 AlimTalk 限整个空间累计发送给 3 人（分批发送也会合计）。如果广告性 AlimTalk 的发送时间落在晚上 9 点至早上 8 点（韩国时间），系统会自动预约到预约时间之后的第一个 08:00（韩国时间）；信息性 AlimTalk 会立即发送。关联需要营业执照、Kakao Business 渠道（Kakao 审核需 3～4 天）、客服中心号码、验证码和关联费 50,000 韩元（不含增值税）；关联操作由用户直接在网页上完成
短信	SMS	根据服务端设置可能可用（channels[SMS].available）	仅发送信息性通知（若为广告内容，则返回 400 J_41_21_1_10，请通过 AlimTalk·电子邮件发送）。每条 50 韩元（预付）。必须在 Jober 电子文档设置中启用短信发送（若未启用，则返回 409 J_41_23_1_19 + data.settingsUrl）。注册发件号码之前，最多可使用 Jober 公用号码发送 3 条；注册之后，每天最多 50 人、每次最多 30 人、累计最多 300 人（超过则返回 409 J_41_23_1_18）。开头会添加 [스페이스 이름]，正文最多 800 字节（约 400 个韩文字符）；超过 90 字节时会以 LMS 发送。若服务端关闭了短信功能，传入此渠道会返回 400 J_41_21_1_8

• 请通过 get_send_readiness 的 channels[]（顺序为 EMAIL·KAKAO·SMS）和 onboarding.nextStep 确认实际可用的渠道。根据服务端设置，电子邮件可能尚未开放（404 J_41_20_1_2）。
• 现有调用若未传入 channel，则全部按 AlimTalk（KAKAO）处理。未关联 Kakao 渠道的空间默认由电子邮件和 AlimTalk 共用 10 次体验额度（见 notices 中的 EMAIL_SHARES_KAKAO_TRIAL）。充值也不会增加这 10 次额度。根据服务端设置，可能不共享体验额度，而是限制注册初期每天最多 200 人；请通过 channels[EMAIL].quota 确认实际限额。
• 确定发送人数后，请在 get_send_readiness 中传入 targets。channels[].capacity 会显示当前可发送人数（now）、不足人数（shortBy）和解除限制的方法（unlock：充值 CHARGE·关联 Kakao 渠道 CONNECT_KAKAO_CHANNEL·等待次日 WAIT_DAILY_RESET）。
• 余额不足时会返回 409 J_41_23_1_14；向用户提供 data.prepaidUrl（充值）·data.pricingUrl（套餐）即可。

准备事项

• Node.js 18 或更高版本
• Jober 账户和空间。若没有，请由用户亲自在 https://jober.io/start/ai?src=mcp&client=local 注册（没有创建账户的 API 或工具）。
• 建议关联 Kakao 渠道，但并非必需。未关联时，可通过 Jober 公用渠道发送，限额与网页发送相同（如体验 10 次）；外部链接·广告优惠券 AlimTalk 限整个空间累计发送给 3 人（分批发送也会合计；电子邮件不受此限制）（未关联渠道时的发送限额）。
• Jober 个人 API 密钥：由空间管理员在 https://jober.io/settings/integrations（设置 > AI 工具集成 > 个人 API 密钥）中生成。 密钥（jbr_live_...）只会在生成后显示一次，请妥善保存。不再需要的密钥可在同一页面立即撤销。 同一页面中的公司 API 密钥（jbr_co_...）用于公司内部服务器集成（发送 API·自由发送 REST），不能用于 MCP（放入此软件包后会进入仅提供说明的模式，通过远程 URL 请求头发送则会返回 HTTP 401）。

安装

请将以下示例中的 jbr_live_xxxxxxxx 替换为已生成的密钥。请勿将密钥提交到代码库。

Claude Code

claude mcp add jober -e JOBER_API_KEY=jbr_live_xxxxxxxx -- npx -y @joberhr/jober-mcp

Claude Desktop

claude_desktop_config.json（macOS：~/Library/Application Support/Claude/，Windows：%APPDATA%\Claude\）

{
  "mcpServers": {
    "jober": {
      "command": "npx",
      "args": ["-y", "@joberhr/jober-mcp"],
      "env": {
        "JOBER_API_KEY": "jbr_live_xxxxxxxx"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json（全局）或项目中的 .cursor/mcp.json

{
  "mcpServers": {
    "jober": {
      "command": "npx",
      "args": ["-y", "@joberhr/jober-mcp"],
      "env": {
        "JOBER_API_KEY": "jbr_live_xxxxxxxx"
      }
    }
  }
}

VS Code

.vscode/mcp.json（首次运行时会通过输入窗口输入密钥）

{
  "inputs": [
    {
      "type": "promptString",
      "id": "jober-api-key",
      "description": "Jober API key (jbr_live_...)",
      "password": true
    }
  ],
  "servers": {
    "jober": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@joberhr/jober-mcp"],
      "env": {
        "JOBER_API_KEY": "${input:jober-api-key}"
      }
    }
  }
}

直接连接远程 URL（OAuth）

支持远程 MCP（Streamable HTTP）的客户端无需安装软件包，只需添加 https://api.jober.io/mcp。 首次连接时，浏览器会打开 Jober 登录和权限同意页面。授权后，即可通过 OAuth 2.1（PKCE）令牌连接。 在 claude.ai 和 ChatGPT 的自定义连接器中输入同一地址即可。

如需断开连接，请在 Jober 网站的 设置 > AI 工具集成页面中的已连接 AI 工具列表里，点击相应应用的[断开连接]。断开后，该连接的所有令牌会立即失效，后续调用将返回 401。请在同一页面的 API 密钥列表中撤销 API 密钥。

# Claude Code
claude mcp add --transport http jober https://api.jober.io/mcp

// Cursor (mcp.json)
{ "mcpServers": { "jober": { "url": "https://api.jober.io/mcp" } } }

// VS Code (.vscode/mcp.json)
{ "servers": { "jober": { "type": "http", "url": "https://api.jober.io/mcp" } } }

如需使用个人 API 密钥而非 OAuth，请添加 Authorization: Bearer jbr_live_xxxxxxxx 标头 （例如：claude mcp add --transport http jober https://api.jober.io/mcp -H "Authorization: Bearer jbr_live_xxxxxxxx"）。

仅提供指南的模式（未设置密钥时）

如果 JOBER_API_KEY 为空、格式不符合个人 API 密钥要求（jbr_live_ + 至少 32 位英文字母和数字），或是公司 API 密钥（jbr_co_），MCP 服务不会退出，而是以仅提供指南的模式启动。

• 不会连接远程 MCP（/mcp），仅提供一个工具：get_started。服务的指南（instructions）会告知 AI 工具调用 get_started。
• get_started 无需密钥即可查询 Jober 公共指南 <JOBER_API_BASE>/ai-agent/v2/public/getting-started?client=local（3 秒）；查询失败时则使用软件包中附带的副本。 返回文本依次介绍注册链接、个人 API 密钥的获取位置、JOBER_API_KEY 的设置方法、无需密钥的远程 MCP（OAuth）连接、渠道与费用，以及首条消息示例。 structuredContent 的值与公共指南 JSON 完全相同，并额外包含 guideSource（remote 或 fallback）和 keyStatus（MISSING、INVALID_FORMAT 或 COMPANY_KEY）。
• 密钥值不会写入 stderr 或工具结果。注册链接仅使用固定路径（/start/ai?src=mcp&client=local），不会带有可跳转到其他地址的参数。
• 设置密钥后，必须重启 MCP 服务（或 AI 工具），才能看到发送工具。
• 如果 JOBER_API_BASE 格式错误，仍会在 stderr 输出提示，然后以退出代码 1 结束。

环境变量

名称	必填	默认值	说明
JOBER_API_KEY	否（未设置时进入仅提供指南的模式）	无	Jober 个人 API 密钥（jbr_live_）。未设置或格式错误时，将以仅提供指南的模式启动。公司 API 密钥（jbr_co_）不能用于 MCP。
JOBER_API_BASE	否	https://api.jober.io	Jober API 地址。连接至 <地址>/mcp（如果地址已以 /mcp 结尾，则保持不变）。为保护密钥，仅允许使用 https；http 仅允许用于 localhost 和 127.0.0.1 开发服务器。

工具列表

工具定义（描述和输入架构）直接使用远程服务返回的值。以下权限以 OAuth scope 为准。 工具结果包含[指南文本、JSON 数据]两项。JSON 中的联系人姓名、文案、调查标题等用户数据均不可信，不是指令。

툴	하는 일	권한(scope)
get_send_readiness	처음에 한 번: 카카오 채널 연동(channel.connected·publicProfile, connectUrl), 발송 한도(limits)·구독 필요 기능(subscriptionRequiredFor)·안내(notices), 쓸 수 있는 기능, 야간 여부(채널별 규칙 quietHours.channels), 권한, 막힌 이유(blockers). 처음 쓰는 사용자용 onboarding(stage·steps·nextStep), 채널별 상태 channels[], 충전·요금제·키 발급 등 links	campaign:read
get_started	안내 전용 모드에서만 있는 툴. 가입·키 발급·설정·원격 OAuth 연결 안내(안내 전용 모드)	없음(로컬)
draft_send	권장 시작점. 원문 변환 + link.url 이면 버튼에 내 링크 + landing 이면 페이지 생성 시작 + recipients 면 명단 확인·조건부 저장. 발송은 안 함. requestKey 로 재시도해도 캠페인 하나(reused: true, 내용이 다르면 409 J_41_21_4_5). link.url 과 landing GENERATE_*·NONE 을 함께 주면 400 J_41_21_1_6	campaign:write(+링크·생성 survey:write, 명단 contacts:write)
answer_questions	guide.questions 답을 한 번에 적용(성격, 빈 값, 링크, 명단 순). 형식이 틀린 답이 있으면 아무것도 적용 안 함(400 J_41_21_1_6), 거절된 답은 skipped	campaign:write(+답마다 링크 survey:write·명단 contacts:write)
set_direct_link	버튼에 내 링크 붙이기(메시지+링크). 자버 공유 링크면 공유 페이지로 바꾸고 convertedTo: "SELECT_SHARE"	survey:write
convert_message	문자 원문을 알림톡 캠페인 초안으로 변환(링크·명단까지 한 번에 하려면 draft_send)	campaign:write
get_campaign	캠페인 상세(상태, 서식, 변수, 미리보기, 경고, 발송 전이면 limits) 조회. status 는 조회할 때마다 계산한 값(아래 캠페인 상태). 조회할 때 멈춘 접수를 정리하며, 접수 중인 발송이 있으면 pendingOperation(status: "SUBMITTING")을 함께 돌려줌	campaign:read
update_campaign	발송명·변수 값·서식 수정. 사용자가 원할 때만 정보성/광고성 선택(서버가 자동으로 광고로 정한 캠페인은 정보성으로 바꿀 수 있지만, 할인·쿠폰 내용이 남아 있으면 광고를 유지하고 explanation 으로 이유를 알려 줌, 원문 분석이 광고면 바꿀 수 없음). 쿠폰명에 홍보 표현을 넣으면 400 J_41_21_1_4. 정보성 알림톡의 쿠폰명·사용기한·쿠폰확인방법·이용권명에 할인율·1+1·증정·무료 제공·이벤트 같은 광고 표현을 넣어도 400 J_41_21_1_4(data.reason: "AD_CONTENT_IN_INFO", 쿠폰명의 혜택 상세는 서버가 지우고 AD_CONTENT_REPLACED). optOutLink: false 는 정보성 안내만(광고·쿠폰은 400 J_41_21_1_6, OPT_OUT_REQUIRED). 이메일은 email, 문자는 sms.text. scheduledAt(ISO, null = 지금)으로 보낼 시각을 캠페인에 정해 두면 prepare_send 가 시각을 받지 않을 때 그 값을 씀(1분 뒤 이후 아니면 400 J_41_23_1_5)	campaign:write
list_templates	사용할 수 있는 알림톡 서식 목록	campaign:read
list_surveys	랜딩으로 붙일 수 있는 기존 설문과 공유 링크 목록	campaign:read
generate_survey	설문 랜딩 페이지 생성 작업 시작(needQuestions: true 면 응답을 받는 질문까지 생성, 기본은 안내 페이지). 진행 중인 작업이 있으면 새로 만들지 않고 reused: true 로 돌려주며, 스페이스당 하루(KST 자정 초기화) 50건 한도	survey:write
select_survey	기존 설문(또는 공유 링크)을 랜딩으로 연결하거나 해제	survey:write
edit_page	자버 자동 안내 페이지(또는 쿠폰 사용 화면)를 사용자 말대로 고치기. 안내 페이지는 instruction 에 요청을 그대로(예: "배경색을 따뜻한 색으로 바꿔 줘", "두 번째 문단을 짧게", "주차 2시간 무료라고 추가해 줘"), 쿠폰 화면은 coupon{field: benefitName·amount·expiry·howToUse, value}. 비동기 작업이라 job 을 돌려주고(고치는 동안에도 지금 페이지를 그대로 쓸 수 있음) get_job 이 끝나면 edit.text(예: "안내 페이지를 고쳤어요.")와 새 미리보기를 보여 주세요. 바뀌는 곳만 고치고, 원문에 없는 숫자가 생기거나 광고 첫 부분에 홍보 문구가 들어가면 지금 페이지를 그대로 둡니다. 광고 없는 안내 페이지에 홍보를 더해 달라고 하면("할인 강조해 줘") 원래 안내 내용이 남고 첫 부분이 안내로 시작할 때만 반영하고 정보성으로 유지합니다(빠지면 지금 페이지 그대로, edit.text 에 이유). 자동 안내 페이지가 아니면 409 J_41_22_4_20, 고치는 중이면 409 J_41_22_4_21. 쿠폰 화면의 쿠폰명·기한은 알림톡에도 있으니 update_campaign 을 먼저 부르고 끝난 뒤 edit_page 를 부르세요(동시에 부르면 고친 화면이 버려짐, CANCELED J_41_22_4_16). 안내 페이지·쿠폰 화면 수정은 스페이스 하루 생성 수 제한에 세지 않음(만들기만 셈). 알림톡·메일·문자 문구는 update_campaign. update_campaign 이 알림톡에 없는 칸이라 data.reason NOT_IN_MESSAGE·nextActions edit_page 를 주면(예: 할인 내용이 안내 페이지로 옮겨진 캠페인의 "염색 20% 할인으로 바꿔 줘") 안내 페이지를 고칠지 물은 뒤 edit_page 에 요청을 그대로 넣습니다	survey:write
get_job	설문 생성·페이지 수정 작업 진행 상태 조회(수정 작업은 edit{kind, applied, text}, CANCELED 는 웹에서 취소했거나 생성 중 내용이 바뀌어 결과를 버린 경우). 끝나면 result.openUrl(만든 페이지를 로그인 없이 보는 공개 미리보기, 7일)을 사용자에게 바로 보여 주세요. result.editUrl 은 자버에서 고치는 편집 주소(로그인 필요)입니다	campaign:read
preview_recipients	연락처 목록 검증 미리보기(유효·중복·기존 연락처·수신거부 수)	contacts:write
commit_recipients	연락처 등록과 발송 대상 지정, 개인화 변수 연결	contacts:write
send_test	확정한 캠페인을 1명에게 테스트로 보내기(실제 발송). 알림톡·문자는 phone, 이메일은 email(비우면 내 연락처 = get_send_readiness 의 testSend.prefill). 다른 번호·주소도 됩니다(형식만 확인, 틀리면 400 J_41_23_1_6, 연락처는 만들지 않음). 스페이스 하루 5번(웹·AI 도구·채널 합산, 넘으면 409 J_41_23_1_17), 결과 testQuota.remaining	send:execute
prepare_send	발송 준비: 대상 수, 예상 비용, 미리보기, 한도(summary.limits·notices), 확인값 발급. scheduledAt 을 주지 않으면 update_campaign 으로 정해 둔 시각(없으면 즉시). 문자는 야간에도 예약하지 않고 밤 9시~아침 8시면 summary.warnings 에 SMS_NIGHT_NOTICE 안내. 밤의 광고성 알림톡만 예약 시각 이후 첫 08:00(한국 시간)으로 자동 예약(summary.adjustments, 정보성 알림톡·이메일은 야간에도 즉시, 이메일은 늘 EMAIL_NIGHT_ALLOWED 안내), 채널 미연동 링크·광고 3명 상한 초과 409 J_41_23_1_13, 목적지가 있는데 링크 버튼 템플릿이 없으면 409 J_41_23_4_4(NO_BUTTON_TEMPLATE), 사용기한이 보내는 날보다 앞이면 400 J_41_23_1_11(revision 을 넘기면 그사이 내용이 바뀐 경우 409 로 알림)	send:execute
submit_send	준비된 발송을 실행 또는 예약. 실행 때도 채널·한도를 다시 확인(J_41_23_1_13, 체험 10건 J_41_23_1_9). 같은 idempotencyKey 재호출은 replayed: true 로 같은 결과	send:execute
cancel_scheduled_send	예약 발송 취소(스팸 검토를 기다리는 예약 포함, 결과 {status: "CANCELED"}). 관리자가 승인 처리 중이면 409 J_41_23_4_6(approvalInProgress: true)	send:execute
get_campaign_results	발송 결과(전달·문자 대체·실패·열람·응답) 숫자 조회. AI 해설은 explain: true 일 때만	campaign:read
prepare_reminder	미열람·미응답자 대상 재알림 캠페인 준비(아직 보내지 않은 같은 재알림이 있으면 새로 만들지 않고 reused: true 로 돌려줌)	campaign:write
list_campaigns	최근 캠페인 목록	campaign:read

권장 흐름 (guide 따르기)

캠페인이 담긴 툴 결과의 campaign.guide(발송 준비·실행·작업 조회는 최상위 guide)가 지금 단계(stage), 사용자에게 물을 질문(questions), 다음에 부를 툴과 미리 채운 인자(nextActions[].args)를 알려 줍니다.

1. get_send_readiness: 처음 쓰는 사용자면 onboarding.nextStep 을 그대로 안내합니다. 채널은 묻지 않습니다(서버가 정하고 campaign.channelDecision 으로 알려 줍니다). 채널 미연동이면 notices 안내와 limits 의 남은 수(체험 10건, 링크·광고 3명)를 사용자에게 알립니다(연동을 원하면 channel.connectUrl).
2. draft_send: 부르기 전에 "템플릿을 찾는 데 몇 초 걸려요"라고 알리고, 원문(필요하면 link.url, recipients 까지)으로 초안을 만듭니다. 결과에 받는 분 화면 미리보기 이미지(MCP image content)가 붙고, 이미지를 못 보여 주는 도구는 preview.previewUrl(로그인 없이 여는 미리보기 페이지, 7일) 링크를 사용자에게 줍니다. campaign.explanation.text(+ why)로 무엇을 왜 바꿨는지 짧게 전합니다.
3. guide.questions 에 남은 것(명단·버튼 뒤 페이지·광고 이메일 보낸 곳)만 묻고 answer_questions 로 답합니다. 버튼 뒤 페이지를 정하면 바뀐 미리보기를 다시 보여 줍니다. 문구를 고치고 싶다고 하면 update_campaign.
4. 확정되면 send_test 로 내 번호·메일에 테스트 발송을 권합니다(하루 5번).
5. prepare_send → submit_send → get_campaign_results. 카카오 채널 연동·문자 켜기·발신번호 등록·충전이 필요해 막히면 결과의 링크(channels[].setup·data.settingsUrl·data.prepaidUrl·connectUrl)를 주고, 사용자가 자버에서 마치고 돌아오면 이어서 진행합니다.

질문 종류(kind): SLOT_VALUE(빈 값, id slot.<변수키>), RECONVERT(답 불가, 원문 보강), LANDING_LINK(id landing.link, URL+url·GENERATE_INFO·GENERATE_SURVEY·EXISTING+frameId/shareOptionId·NONE, 원문에 주소가 있으면 그 주소를 추천), SEND_LIMIT_EXCEEDED(답 불가, stage BLOCKED, 명단이 한도의 남은 수보다 많음, context: {code, remaining, limit, targets, connectUrl}, 선택지 받는 사람 줄이기·채널 연동·요금제 확인), CHANNEL_REQUIRED(비상시에 채널 연동을 다시 필수로 켰을 때만, 답 불가), RECIPIENTS(id recipients, headers·rows), COLUMN_MAPPING(id recipients.columnMap). 광고·정보성(NATURE_CHOICE)과 수신 동의(SEND_BASIS)는 서버가 더 묻지 않습니다(값은 하위 호환으로만 남음): 광고·정보성은 서버가 정하고, 광고면 prepare_send 의 consentConfirmed: true 로 수신 동의(쿠폰 안내는 혜택 지급까지)를 한 번 확인합니다. 사용자가 정보성으로 바꾸고 싶다고 하면 answer_questions 의 {id: "nature", value: "INFO"} 나 update_campaign 의 natureChoice 로 보냅니다. 야간 시각과 수신거부는 묻지 않습니다. 채널 미연동이어도 링크 질문에는 모든 선택지가 나오고, 링크·광고 3명 상한의 남은 수가 0 이면 URL 만 빠집니다.

캠페인 상태

status 는 저장된 값이 아니라 조회할 때마다 서버가 발송 작업과 스팸 검토 기록으로 계산합니다(웹·MCP·REST 동일).

status	뜻
DRAFT·NEEDS_INPUT·READY·PREPARED·BLOCKED	발송 전(초기값·빠진 값 있음·준비 가능·준비 완료·스팸 차단)
SCHEDULED	예약 접수(스팸 검토를 기다리는 예약 포함)
SENDING	발송 중, 접수 결과 확인 중(pendingOperation), 또는 스팸 검토를 기다리는 즉시 발송
SENT	발송 완료
CANCELED	canceledReason: SCHEDULE_CANCELED(예약 취소)·SEND_STOPPED(발송 중단·스팸 검토 거부)
FAILED	발송 작업을 찾을 수 없음

• pendingOperation.status 는 SUBMITTING 하나입니다(UNKNOWN 은 더 이상 오지 않습니다). 접수가 5분 안에 끝나지 않으면 서버가 정리해 READY 로 돌아갑니다.

채널 미연동 발송 한도

카카오 채널 연동은 필수가 아닙니다. 연동하지 않으면 자버 공용 채널로 웹과 같은 검사(스팸·공용 채널 금지 표현·구독·선불 잔액)를 거쳐 보냅니다. limits[] 항목은 {code, applies, limit, used, remaining, exempt, errorCode} 입니다.

code	한도	넘으면
FREE_DOCUMENT	구독 없음: 10(삭제한 문서 제외)	J_41_23_1_9(sourceErrorCode J07994)
UNCONNECTED_KAKAO	채널 미연동: 10(삭제한 문서 포함 + 접수 중 에이전트 발송, 면제 고객은 exempt: true)	J_41_23_1_9(J_07_53_01_2·J_07_53_01_1)
AGENT_UNCONNECTED_LINK_AD	공용 채널로 나가는 외부 링크·광고 쿠폰 안내: 받는 사람 3명 누적(면제 고객 포함, 스팸 검토 거부·테스트 발송 포함)	409 J_41_23_1_13(data.remaining·connectUrl)
PREPAID_BALANCE	선불 잔액(balance, estimatedUnitCost)	J_41_23_1_9(J_07_99_1_1·J_07_99_1_2)

• 실리는 곳: get_send_readiness 의 limits, 발송 전 캠페인의 campaign.limits, prepare_send 의 summary.limits, 한도 거절의 data.limits. notices[] 는 UNCONNECTED_PUBLIC_PROFILE·TEST_SEND_CHARGE·QUIET_HOURS_SUBSCRIPTION, subscriptionRequiredFor 는 구독이 없으면 ["SCHEDULED", "VARIABLE_LINK"] 입니다.
• 채널 미연동이어도 링크 버튼 템플릿으로 보냅니다. 목적지가 있는데 맞는 버튼 템플릿이 없으면 409 J_41_23_4_4(NO_BUTTON_TEMPLATE)로 막고, 버튼 없이 바꿔 보내지 않습니다.
• J_41_23_1_10(채널 미연동 거절)은 자버가 비상시에 채널 연동을 다시 필수로 켰을 때만 납니다. J_41_23_1_4 는 더 이상 내지 않습니다.

내 링크 붙이기 (메시지+링크)

draft_send 의 link.url, landing.link 의 URL 답, set_direct_link 는 같은 기능입니다. 알림톡 버튼을 누르면 그 주소가 열립니다.

• 붙이기 전에 주소와 도메인(쿼리 속 리다이렉트 목적지 포함)을 스팸 기준으로 검사합니다.
• http·https 공개 주소, 500자 이하만 됩니다. 사설 IP·localhost·.internal·아이디/비밀번호가 든 주소는 400 J_41_22_1_12, 버튼 주소가 고정된 템플릿은 J_41_22_1_13, 스팸 판정 차단은 J_41_22_1_14(data.restrictedKeywords), 검사할 내용이 너무 길면 J_41_22_1_15 입니다.
• 단축 주소는 막지 않지만 신고될 수 있으니 원래 주소를 권하세요. 자버 공유 링크는 공유 페이지(SELECT_SHARE)로 바꿔 붙입니다.
• 받는 사람 모두 같은 링크입니다. 결과의 열람은 버튼을 누른 수이고 응답은 null 입니다. 광고·쿠폰 안내면 경고 LINK_LANDING_NOTICE(링크 첫 화면에 혜택 안내가 먼저 보이게)가 붙습니다.

발송 안전장치

실제 비용이 드는 발송은 웹과 같은 규칙으로 서버가 검사합니다. 이 패키지는 요청을 전달만 하므로 우회할 수 없습니다.

• 2단계 발송: prepare_send 가 대상 수·예상 비용·렌더된 미리보기와 operationUuid·confirmHash 를 돌려줍니다. submit_send 는 이 값과 새 idempotencyKey 로 호출하며, 준비 이후 대상·본문·서식·비용이 바뀌었으면 거부되어 다시 준비해야 합니다. 별도의 사람 승인 단계는 없고, 발송 가능 여부는 아래 서버 정책으로 판단합니다(자동화 워크플로에서도 그대로 동작).
• 멱등 키: submit_send 는 idempotencyKey 가 필수이며, 같은 키로 다시 호출해도 한 번만 발송됩니다. 이 패키지는 실패한 호출을 자동 재시도하지 않습니다.
• 접수 확인 대기: submit_send 가 409 J_41_23_4_5(pending)를 돌려주거나 get_campaign 에 pendingOperation(SUBMITTING)이 있으면, 같은 operationUuid·confirmHash·idempotencyKey 로 다시 호출해 결과를 받으세요. 키를 잃었으면 새 키로 보내지 말고 get_campaign 으로 상태만 다시 확인합니다(5분 안에 접수가 끝나지 않으면 서버가 READY 로 정리). J_41_23_4_5 의 lastErrorCode 는 마지막 오류 코드(거절 확정 아님)이고, 거절이 확정된 경우만 sourceErrorCode 로 옵니다.
• 풀리지 않는 거절: 구독·선불 잔액·연동비·발송 한도 같은 웹 발송 검증 거절은 J_41_23_1_9(data.sourceErrorCode = 원래 코드, data.sourceMessage = 원문 메시지)이며 needsPrepare 가 없습니다. 다시 준비해도 같은 결과이므로 원인을 해결한 뒤 진행하세요. prepare_send 도 이 검증을 미리 하므로 대부분 준비 단계에서 걸립니다.
• 다시 준비 여부: 실패 응답에 data.needsPrepare 가 있으면 prepare_send 부터 다시 하세요. 준비 만료(J_41_23_4_1), 확인값·상태 변경(J_41_23_4_2), 받는 사람 값 변경(J_41_23_2_1), 실패한 멱등 키 재시도(J_41_23_2_2) 등에 붙습니다. 아래 조건 거절(J_41_23_1_9)과 템플릿 변경(J_41_23_4_11, 원문 다시 변환 필요)에는 붙지 않습니다. J_41_23_4_2 에 data.status(발송 중·예약·완료·취소)가 있거나 같은 키 재시도 응답에 data.stopped 가 있으면 다시 준비하지 말고 get_campaign 으로 상태를 확인하세요.
• 결과 조회 상태: get_campaign_results 응답의 campaignStatus·canceledReason(SEND_STOPPED = 발송 중단·스팸 검토 거부, SCHEDULE_CANCELED = 예약 취소)은 get_campaign 과 같은 규칙으로 계산한 캠페인 상태이고, statsAvailable: false 면 집계할 발송 결과가 없습니다.
• 멈춘 제출: submit_send 가 409 J_41_23_4_9(data.superseded = true, notSent: true)를 돌려주면 접수 확인이 늦어져 이 요청은 발송 작업을 만들지 않고 멈춘 것입니다. data.reason 은 NEWER_SUBMISSION(새 제출이 먼저 접수) 또는 STALE_SUBMISSION(새 제출 없이 멈춤)입니다. 바로 다시 준비하지 말고 get_campaign 으로 상태를 확인하고, 캠페인이 READY·PREPARED 면 사용자 확인 뒤 prepare_send 부터 다시 할 수 있습니다.
• 확정값 발송: 예약 발송을 포함해 실제 발송은 submit_send 때 확정한 받는 사람(번호·이름)과 개인화 값으로 나갑니다. 그 뒤 연락처를 바꿔도 이미 확정한 발송 내용은 바뀌지 않습니다.
• 링크 없이 보내기: select_survey 의 NONE 은 같은 템플릿의 버튼 없는 변형으로 바꿔 보냅니다. 버튼 없는 변형이 없는 템플릿(get_campaign 의 noLinkAvailable: false)은 NONE 이 400 J_41_22_1_11 이니 연결할 링크를 골라 주세요.
• 개인화 변수 연결(재확정): commit_recipients 의 변수 연결은 매번 그 요청의 customColumnMap 기준으로 다시 정해집니다. 명단을 다시 확정할 때 기존 연결을 유지하려면 같은 칸에 variable 을 다시 지정하세요. variable 을 빼거나 그 칸을 빼면 연결이 풀리고(unboundVariables) 값을 다시 묻습니다.
• 수신자 제한: 발송 대상은 commit_recipients 로 서버에 등록된 캠페인 대상뿐이며, 전화번호를 발송 요청에 직접 넣을 수 없습니다.
• 야간 자동 예약(채널별): 야간 규칙은 채널별이에요. 광고성 알림톡만 밤 9시~아침 8시(한국 시간)에 보내지 않고, 그 시간에 준비하면 예약 시각 이후 첫 08:00(한국 시간)으로 자동 예약해요(summary.adjustments). 정보성 알림톡과 이메일(광고성 포함)은 야간에도 자동 예약 없이 바로 보내요. 이메일 prepare_send 에는 늘 EMAIL_NIGHT_ALLOWED 안내가 붙어요. 채널별 규칙은 get_send_readiness 의 quietHours.channels 에 있어요. 이 시간에 광고성 알림톡으로 prepare_send 를 부르면 묻지 않고 예약 시각 이후 첫 08:00(한국 시간)으로 예약하고 summary.adjustments(QUIET_HOURS_RESCHEDULED)로 알려 줍니다. 그대로 submit_send 하면 예약됩니다. 옮긴 날이 사용기한보다 뒤면 400 J_41_23_1_11, 같은 날이면 경고 EXPIRY_SAME_DAY. 지금 보내기로 준비했는데 submit_send 시점이 야간이면 400 J_41_23_1_2(data.needsPrepare: true)이니 prepare_send 를 다시 부르면 08:00 자동 예약이 됩니다.
• 채널 미연동 한도: 채널 연동은 필수가 아닙니다. 미연동이면 체험 10건(삭제 포함)과 외부 링크·광고 쿠폰 알림톡의 스페이스 누적 3명 상한(발송을 나눠도 합산, 409 J_41_23_1_13)을 prepare_send·submit_send 때 두 번 확인합니다. 다시 준비해도 풀리지 않으니 받는 사람을 줄이거나 채널을 연동하세요(채널 미연동 발송 한도).
• 연쇄 변경 중단: draft_send·answer_questions 도중 다른 요청이 캠페인을 바꾸면 성공 응답 안에서 남은 단계만 멈추고 skipped·failedSteps 에 J_41_21_4_2 + data.stoppedBy 가 남습니다. get_campaign 으로 최신 상태를 보고 다시 답하세요.
• 수신거부 링크 기본 켬: 정보성 안내까지 기본으로 붙습니다(정보성 이메일은 (광고)·보낸 곳 없이 수신거부만). 정보성만 update_campaign 의 optOutLink: false 로 끌 수 있습니다. 붙일 수 없는 템플릿이면 경고 OPT_OUT_UNAVAILABLE.
• 서버 정책 동일 적용: 스팸·금지 업종 차단, 광고성 메시지의 수신 동의 확인(prepare_send 의 consentConfirmed, 없으면 400 J_41_23_1_3), 1000자 제한, 잔액·발송 한도 검사.
• 사후 확인: 발송되면 스페이스 관리자에게 바로 알림이 가고, 예약 발송은 cancel_scheduled_send 나 웹에서 취소할 수 있습니다.
• 키 관리: 개인 API 키는 발급한 관리자 개인에게 귀속되고 서버에는 해시로만 저장됩니다. 의심되면 설정 > AI 도구 연동에서 즉시 폐기하세요. 이 패키지는 키를 환경 변수로만 받고 https 로만 보냅니다.

故障排除

连接阶段的错误（认证 401、权限·MCP 使用·封禁 403、调用限额 429、404）会以 HTTP 状态码返回，本包会通过下方 …(HTTP 401) 这样的消息告知。 工具执行期间的错误会以 HTTP 200 的正常 JSON-RPC 响应返回，其中 result.isError: true，并通过 content 中的 errorCode 判别（见下方 J_ 代码行）。 代码旁括号中的数字表示相同代码对应的自由发送 API（REST）HTTP 状态码；在 MCP 中不会以 HTTP 状态码返回。

症状	检查事项
只看到 get_started 一个工具，stderr 中出现 guide mode	这是仅提供指南的模式。确认客户端配置的 env 中已填入个人 API 密钥（以 jbr_live_ 开头的完整值），然后重启 MCP 服务
认证失败（HTTP 401）	检查密钥是否有误或已撤销，必要时申请新密钥。如果没有 자버 账号，请通过消息中的注册链接（https://jober.io/start/ai?src=mcp&client=local）注册后申请密钥
J_41_23_1_14（工具错误，REST 409）	预付余额不足。通过 data.prepaidUrl 充值，或减少收件人后重新准备（data.balance·estimatedCost·shortBy）
J_41_20_1_2（工具错误，REST 404）	尚未开放电子邮件发送。请通过通知톡（KAKAO）发送
J_41_21_1_8·J_41_21_1_7（工具错误，REST 400）	此服务尚未启用短信（SMS）（channels[SMS].available: false，reason: "FLAG_OFF"）；其他 channel 值无效。请使用 EMAIL·KAKAO·SMS 中可用的渠道
J_41_21_1_10（工具错误，REST 400）	不能通过短信发送广告内容。请改用通知톡或电子邮件（data.suggest）
J_41_23_1_17（工具错误，REST 409）	当天的测试发送次数 5 次已用完（按空间·渠道合计，data.resetAt 时可再次发送）
J_41_23_1_18·J_41_23_1_19（工具错误，REST 409）	超出短信发送限额（data.code），或未在 자버 启用短信发送（将 data.settingsUrl 提供给用户）
자버 AI Agent 连接尚未准备就绪（HTTP 403，J_41_25_3_1）	자버 MCP 连接尚未开放。在此期间请通过网页（https://jober.io/ai/kakao/infotalk）使用
没有权限（HTTP 403）	检查密钥权限（scope）和空间的 MCP 使用设置。如果是账号·IP 封禁，则为 J_41_25_3_4
J_41_22_3_1（工具错误）	密钥所有者没有查看·修改该空间联系人的权限
请求过多（HTTP 429）	稍后重试（J_41_25_4_4）
J_41_22_4_17·J_41_20_4_2（工具错误）	如果是每日调查创建限额，则为 J_41_22_4_17（KST 午夜重置，在此之前可通过 list_surveys 使用现有调查）；如果是内容检查调用限额，则为 J_41_20_4_2
J_41_23_4_5（工具错误，REST 409，pending）	正在确认受理结果。稍后使用相同的 idempotencyKey 再次调用，即可获取结果
J_41_23_2_3（工具错误，REST 503）	在 prepare_send·submit_send 期间暂时无法确认 Kakao 渠道状态（HTTP 200，result.isError: true，content 中的 errorCode）。不会附带 needsPrepare。请稍后再次调用相同工具。submit_send 会在确认前停止，准备内容保持不变，因此请使用相同的确认值再次调用（idempotencyKey 可以重复使用相同值，也可以重新生成）
J_41_23_1_13（工具错误，REST 409）	渠道未关联时，外部链接·广告优惠券通知톡的空间累计人数上限为 3 人，现已超出（分批发送也会合计，data.remaining）。请减少收件人并从 commit_recipients 重新开始，或通过 data.connectUrl 关联渠道
J_41_23_4_4（工具错误，REST 409，NO_BUTTON_TEMPLATE）	设置了目的地，但没有链接按钮模板。若要不带链接发送，请在 select_survey 中选择 NONE 后重新准备
J_41_23_1_10（工具错误，REST 400）	仅在紧急情况下重新启用必须关联渠道时出现。请通过 data.connectUrl 完成关联，然后从 prepare_send 重新开始
J_41_23_1_2（工具错误，REST 400，needsPrepare）	准备立即发送广告通知톡，但执行时间处于夜间。请重新运行 prepare_send（自动预约至 08:00）
J_41_23_1_1（工具错误，REST 400）	文案检查失败。如果 data.errors[].code 为 PROMOTIONAL_COPY，则表示有宣传用语（如果是联系人字段的值，则查看 count·examples）；如果为 BUTTON_TARGET_FIXED，则表示需要固定地址按钮模板
J_41_23_1_11（工具错误，REST 400）	发送日期晚于有效期。请通过 update_campaign 修改有效期
J_41_22_1_12~J_41_22_1_15（工具错误，REST 400）	无法添加自有链接（地址格式·固定地址模板·垃圾信息判定·检查内容超限）。请使用其他链接，或创建说明页面（GENERATE_INFO）
找不到端点（HTTP 404）	检查 JOBER_API_BASE 的值
无法连接	检查网络、代理和 JOBER_API_BASE

日志和错误消息只会输出到 stderr（stdout 仅用于 MCP 协议）。

开发

npm install
npm test          # 타입 검사 + 빌드 + 단위 테스트(모의 원격 Streamable HTTP 서버로 프록시 검증)
JOBER_API_BASE=http://localhost:4100 JOBER_API_KEY=jbr_live_xxxxxxxx node dist/index.js
# PowerShell: $env:JOBER_API_BASE="http://localhost:4100"; $env:JOBER_API_KEY="jbr_live_xxxxxxxx"; node dist/index.js
JOBER_API_BASE=http://localhost:4100 node dist/index.js   # 키 없이 실행하면 안내 전용 모드(get_started)

内置副本 src/guide-fallback.json 的结构与 jober-api 公开指南（GET /ai-agent/v2/public/getting-started）的响应相同。远程值发生变化时，请同步更新。

许可证

MIT