v2
mcp
mcp

Store a bearer token for an MCP server

Changed on

Store a manually entered MCP credential. Accepts a bare token (sent as Bearer, unchanged from before), an explicit Basic <value> or Bearer <value>, or a complete Authorization: header.

post/api/mcp/token

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

Request body

server_urlstring required

MCP server URL the credential authenticates against

tokenstring password required

Bare Bearer token, Basic/Bearer value, or complete Authorization header

Response

Successful Response

idstring required
providerstring required
type'api_key' | 'oauth2' | 'user_password' | 'host_scoped' | 'device_code' required
titlestring nullable required
scopesstring[] nullable required
usernamestring nullable required
hoststring nullable

Host pattern for host-scoped or MCP server URL for MCP credentials

scopestring nullable

What a user/password login may be used for, e.g. smtp://host[:port]; null for a login saved before scopes existed

mcp_auth_scheme'basic' | 'bearer' nullable

Manual authorization scheme for MCP credentials

is_managedboolean
servicestring
service_namestring nullable
service_iconstring nullable

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status