Skip to main content
POST
Start connecting a server in a tool kit

Authorizations

X-Api-Key
string
header
required

Personal or workspace LangSmith API key. Personal keys identify the user. Workspace keys are limited to server listing and MCP calls and must also supply the end user's OIDC token or X-LangSmith-Identity.

X-Tenant-Id
string
header
required

Workspace UUID. This header selects a workspace; it does not authenticate the caller.

Path Parameters

kit_id
string
required

Tool kit ID, or me for the kit of every server the caller can use

server_id
string
required

Registered server ID or built-in key

Response

Created

A link where you enter an MCP server's credential, or a credential already stored.

auth_id
string
required

Authorization session ID.

display_name
string
required

User-facing integration name.

kind
enum<string>
required

Authorization flow on the page: oauth or secret.

Available options:
oauth,
secret
slug
string
required

Credential connection slug.

status
enum<string>
required

Status is pending until the owner completes the page at VerificationURL, or completed when the credential was stored while starting the session, as for an OAuth connection that uses client credentials.

Available options:
pending,
completed
verification_url
string

VerificationURL is absent for a completed session.