---
title: "Configure plugin MCP requirement"
method: POST
path: "/v1/plugins/{pluginId}/mcp-connections"
tags: ["Plugins"]
---

# Configure plugin MCP requirement

`POST /v1/plugins/{pluginId}/mcp-connections`

Admin-only privileged setup for one declared remote MCP server. The server name and URL are derived from the active plugin config object; the request never supplies a URL and does not start OAuth.

## Path parameters

- `pluginId` string, typeid, required

## Request body

- object
  - `configObjectId` string, typeid, required — Den TypeID with 'cob_' prefix and a 26-character base32 suffix.
  - `serverName` string, required
  - `authType` 'oauth' | 'apikey' | 'none'
  - `credentialMode` 'shared' | 'per_member'
  - `apiKey` string
  - `oauthClient` object
    - `clientId` string, required
    - `clientSecret` string

## Response `200`

Plugin MCP requirement configured successfully.

- PluginArchPluginMcpRequirementConfigureResponse
  - `ok` true, required
  - `item` object, required
    - `binding` object, required
      - `id` string, typeid, required — Den TypeID with 'pmr_' prefix and a 26-character base32 suffix.
      - `configObjectId` string, typeid, required — Den TypeID with 'cob_' prefix and a 26-character base32 suffix.
      - `externalMcpConnectionId` string, required
      - `pluginId` string, typeid, required — Den TypeID with 'plg_' prefix and a 26-character base32 suffix.
      - `serverName` string, required
    - `connection` object, required
      - `id` string, required
      - `name` string, required
      - `url` string, required
      - `authType` 'oauth' | 'apikey' | 'none', required
      - `credentialMode` 'shared' | 'per_member', required
      - `connected` boolean, required
      - `connectedAt` string, date-time, nullable, required
    - `links` object, required
      - `yourConnections` string, required

## Other responses

- `400` — The plugin MCP requirement request was invalid.
- `401` — The caller must be signed in to configure plugin MCP requirements.
- `403` — Only workspace owners and admins can configure plugin MCP requirements.
- `404` — The plugin MCP requirement could not be found.

---

[API](https://skmtc.net/openworklabs/apis/den-api.md) · [All operations](https://skmtc.net/openworklabs/apis/den-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openworklabs/den-api/versions/55ba7d5c7a7b/schema)