개발자 시작 가이드

TypeScript SDK

send-notice.ts — typescript
import { MsgmcpClient } from "@msgmcp/sdk";
​
const client = new MsgmcpClient({
  publicBaseURL: process.env.MSGMCP_PUBLIC_URL!,
  p5BaseURL: process.env.MSGMCP_COMPOSITION_URL!,
  apiKey: process.env.MSGMCP_CUSTOMER_API_KEY!,
});
​
const message = {
  sender_id: "approved-sender",
  recipient: "+821012345678",
  classification: "TRANSACTIONAL",
  mode: "NORMAL",
  requested_type: "AUTO",
  body: "#{name}님, 주문이 접수되었어요.",
  variables: { name: "김엠시" },
} as const;
​
await client.preview(message);
const accepted = await client.send(message, {
  idempotencyKey: "order-123-notice",
});
await client.getMessage(accepted.message_id);

Java SDK

SendNotice.java — java
import dev.msgmcp.MsgmcpClient;
import dev.msgmcp.Models.*;
import java.util.Map;
​
var client = new MsgmcpClient(publicOrigin, p5Origin, apiKey);
var input = new Composition(senderId, "+821012341234",
    Classification.TRANSACTIONAL, Mode.NORMAL, MessageType.SMS,
    null, "주문이 접수되었어요.", Map.of(), null);
var message = client.send(input, persistedIdempotencyKey);
// Keep message.messageId(): delivery is checked later with getMessage.

MCP 호스트 설정 — json
{
  "command": "node",
  "args": ["/absolute/path/to/packages/mcp/dist/stdio.js"],
  "env": {
    "MSGMCP_MCP_NETWORK_ENABLED": "true",
    "MSGMCP_MCP_SEND_ENABLED": "true",
    "MSGMCP_MCP_PUBLIC_BASE_URL": "https://api.messag.io",
    "MSGMCP_MCP_P5_BASE_URL": "https://api.messag.io",
    "MSGMCP_MCP_CUSTOMER_API_KEY": "<발급한 API key>"
  }
}

자주 쓰는 도구