Plottell/ Developers

Public API & MCP

コードから、
構成を。

Claude Code などの AI エージェントが、商品情報を渡すだけで Plottell に構成を起こす。化粧品の構成生成・可視化を、公開 REST API と MCP から。

API キーを発行するnpm: plottell-mcp

化粧品の構成を可視化するなら、Plottell。

生の tldraw を公開する代わりに、壊れにくい sections スキーマで受け渡し。 薬機法を考慮した構成生成、LP / Amazon A+ / SNS への展開まで、エージェントの 1 リクエストで完結します。

Quickstart

3 ステップで動かす

API キーを発行

ダッシュボードの「API キー」でpk_live_… を発行（スコープはプランに応じて）。

.mcp.json に登録

プロジェクトの .mcp.json に plottell-mcp を追加（下のスニペット）。

Claude Code から呼ぶ

「化粧水Aの縦長LP構成を起こして」と頼むだけで、plottell_ai_compose が走ります。

.mcp.json
{
  "mcpServers": {
    "plottell": {
      "command": "npx",
      "args": ["-y", "plottell-mcp"],
      "env": { "PLOTTELL_API_KEY": "pk_live_…" }
    }
  }
}

Reference

エンドポイント / MCP ツール

RESTscope
GET/api/v1/meread
GET/api/v1/canvasesread
GET/api/v1/canvases/{id}read
POST/api/v1/canvaseswrite
PUT/api/v1/canvases/{id}write
DELETE/api/v1/canvases/{id}write
POST/api/v1/canvases/{id}/compositionswrite
POST/api/v1/ai/composeai
scope必要プランできること
readFree 以上Canvas の一覧・取得
writeStandard 以上Canvas の作成・更新・削除・構成追加
aiEnterpriseAI 構成生成（/ai/compose）

Example

商品情報から構成を生成する

create: true を付けると、生成した構成からそのまま Canvas を作成します（ai + write スコープ）。

curl
curl -X POST https://plottell.com/api/v1/ai/compose \
  -H "Authorization: Bearer pk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "productName": "ブライトニング化粧水A",
    "description": "ビタミンC誘導体配合。乾燥による くすみ印象をケア。",
    "genre": "cosmetics",
    "mediaType": "lp",
    "create": true
  }'

応答には正規化済みの sections、消費クレジット、（create 時は）作成された Canvas の URL が含まれます。 返ってきた URL を開くと、構成からレイアウトが自動生成されます。

エージェントに、
構成エンジンを。

まずは無料で API キーを発行して、/api/v1/me から試せます。

API キーを発行するサポートを見る