MCP OAuth Client Secret Reference
Kind: mcp_oauth_client_secret
Version: v1
The MCP OAuth client secret resource holds the client secret of an OAuth client that you pre-registered with an MCP server's OAuth provider, along with the token URL and the MCP server it can be used for.
tctl get leaves out spec.client_secret unless you pass
--with-secrets, which requires the read verb on
mcp_oauth_client_secret.
The resource never expires, so metadata.expires must not be set.
Example definition:
kind: mcp_oauth_client_secret
version: v1
metadata:
name: example-client-secret
spec:
# client_id is the OAuth client the secret belongs to.
client_id: "example-client-id"
# client_secret is the OAuth client secret.
client_secret: "************************************"
# token_url is the only URL the client secret is sent to.
token_url: https://auth.example.com/oauth/token
# mcp_server_uri is the uri of the MCP server app the secret can be used for.
mcp_server_uri: mcp+https://mcp.example.com/mcp
Top-level fields
Example:
kind: "string"
sub_kind: "string"
version: "string"
metadata: # [...]
spec: # [...]
scope: "string"
| Field Name | Description | Type |
|---|---|---|
| kind | The resource kind. Must be "mcp_oauth_client_secret". | string |
| metadata | The resource metadata. | Metadata |
| scope | The scope of the secret. If unset, the secret is unscoped. The scope of a secret cannot be changed after creation. | string |
| spec | Holds the client secret and where it can be used. | MCP OAuth Client Secret Spec |
| sub_kind | An optional resource sub kind. Must be empty. | string |
| version | The resource version. Must be "v1". | string |
MCP OAuth Client Secret Spec
Holds the client secret and where it can be used.
Example:
client_id: "string"
client_secret: "string"
token_url: "string"
mcp_server_uri: "string"
| Field Name | Description | Type |
|---|---|---|
| client_id | The OAuth client the secret belongs to. It must match the client_id of any app that references the secret. | string |
| client_secret | The OAuth client secret. | string |
| mcp_server_uri | The app uri the secret may be used for. | string |
| token_url | The only URL Auth sends the client secret to. | string |
Metadata
Resource metadata.
Example:
name: "string"
namespace: "string"
description: "string"
labels:
"string": "string"
"string": "string"
"string": "string"
expires: # See description
revision: "string"
| Field Name | Description | Type |
|---|---|---|
| description | Description is object description. | string |
| expires | Expires is a global expiry time header can be set on any resource in the system. | |
| labels | Labels is a set of labels. | map[string]string |
| name | Name is an object name. | string |
| namespace | Namespace is object namespace. The field should be called "namespace" when it returns in Teleport 2.4. | string |
| revision | Revision is an opaque identifier which tracks the versions of a resource over time. Clients should ignore and not alter its value but must return the revision in any updates of a resource. | string |
Was this page helpful?