---
title: "Connect a Kakao PlayMCP toolbox"
method: POST
path: "/connections/mcp/playmcp"
tags: ["Setup · Connections"]
---

# Connect a Kakao PlayMCP toolbox

`POST /connections/mcp/playmcp`

## Request

- Base URL: `https://api.ziggsai.com`
- URL: `https://api.ziggsai.com/connections/mcp/playmcp`
- Auth: HTTP bearer

Exchanges a PlayMCP one-time token, checks the toolbox, and stores refreshable credentials as an MCP connection. Agent access still requires a connection grant.

## Request body

- ConnectPlayMcpDto
  - `oneTimeToken` string, required: One-time token or generated connection prompt from the PlayMCP toolbox. Exchanged once; never stored or returned.

## Response `201`

Created

- McpConnectResponseSchema
  - `connection` ConnectionViewSchema, required
    - `connectionId` string, required
    - `ownerId` string, required
    - `provider` string, required
    - `externalAccountLabel` string, nullable
    - `externalAccountId` string, nullable
    - `scopesGranted` string[]
    - `mcpServerUrl` string, nullable: Remote MCP server URL for `provider: "mcp"` connections.
    - `status` string, required
    - `createdAt` string, date-time
  - `tools` string[], required

---

[API](https://skmtc.dev/ziggsai/apis/ziggs-developer-api.md) · [All operations](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/revisions/eda79030e072?raw)