{
"error": "Forbidden: token holds no claim for the requested account"
}
{
"error": "Forbidden: token holds no claim for the requested account"
}
{
"error": "Forbidden: token holds no claim for the requested account"
}
{
"error": "Forbidden: token holds no claim for the requested account"
}
MCP Servers
Register an MCP server
Add a server so its tools become available to this tenant’s agents. Probe the endpoint with validateMcpServer first: a passing probe is what lets you send verified: true, which is what makes the runtime call the url exactly as you wrote it.
{
"error": "Forbidden: token holds no claim for the requested account"
}
{
"error": "Forbidden: token holds no claim for the requested account"
}
{
"error": "Forbidden: token holds no claim for the requested account"
}
{
"error": "Forbidden: token holds no claim for the requested account"
}
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
tenant
string
required
Tenant whose MCP servers you are managing. Get it from the backoffice GET /auth/v1/me/claudia-projects, which answers with the tenant your credentials cover. A tenant your credentials do not cover is indistinguishable from one that does not exist.
Body
application/json
The MCP server to register.
name
string
required
Display name. The slug agents reference is derived from it, so pick something stable.
Example:
"Acme Orders"
url
string
required
The MCP endpoint, http or https. Sent as written — include the full path the server answers on (commonly ending in /mcp) and set verified after probing it.
Example:
"https://mcp.acme.com/mcp"
authType
enum<string>
required
How Claudia should authenticate. bearer and apiKey require credentials; none, forwarded_user and oauth require that it be omitted.
Available options:
none,
bearer,
apiKey,
forwarded_user,
oauth
Example:
"bearer"
verified
boolean
required
Whether the url is a complete MCP endpoint. Set true only after validateMcpServer answered valid: true for this exact url, auth type, credential and headers; leaving it false makes the runtime append /mcp to the url.
Example:
true
credentials
string
The secret to authenticate with, in full. Stored encrypted and never returned. Required for bearer and apiKey, refused for every other auth type.
Example:
"sk-live-9f3c2b7a"
customHeaders
object
Extra headers to send on every call. Names are lowercased on save; reserved names are dropped rather than rejected.
Show child attributes
Example:
{ "x-acme-region": "br" }
Response
The server as registered.
An MCP server your agents can call tools on.
id
string
required
Use this id to update, delete or re-probe this server.
Example:
"6683f1c2a4b19e0012ab34cd"
name
string
required
Display name, as shown in the Tools screen.
Example:
"Acme Orders"
slug
string
required
Stable key derived from the name: lowercased, with every run of non-alphanumeric characters collapsed into _. Agent configurations reference a server by this key, so renaming a server changes it and is not a cosmetic edit. Unique within the tenant.
Example:
"acme_orders"
url
string
required
The MCP endpoint agents call. Used exactly as stored once verified is true.
Example:
"https://mcp.acme.com/mcp"
authType
enum<string>
required
How Claudia authenticates to this server. none sends no credential; bearer sends the stored secret as Authorization: Bearer <secret>; apiKey sends it as x-api-key; forwarded_user stores no secret and forwards the end user's own token at call time; oauth stores no secret either and lets the CloudHumans MCP gateway resolve the contact's custodied session.
Available options:
none,
bearer,
apiKey,
forwarded_user,
oauth
Example:
"bearer"
credentialsStored
boolean
required
Whether a secret is stored for this server. The secret itself is never returned by this API — to change it, send the new value in full. Always false for none, forwarded_user and oauth, which store no secret by design, and for platform-owned servers, whose credential is held by the platform.
Example:
true
customHeaders
object
required
Extra headers sent on every call to this server. Header names are lowercased on save, and the ones owned by the auth and tenant pipeline (authorization, x-api-key, x-tenant, x-authorization, x-account, x-tenant-name) are dropped — send credentials through credentials, not here.
Show child attributes
Example:
{ "x-acme-region": "br" }
verified
boolean
required
Whether this url was probed successfully and is used as stored. False keeps the legacy behaviour of appending /mcp to the url at call time, so a server whose url already ends in the MCP path answers 404 until it is verified.
Example:
true
platformOwned
boolean
required
Whether CloudHumans owns this server. Platform-owned servers are provided to every tenant and are listed so agents can reference them, but they cannot be changed or deleted — those attempts answer 422.
Example:
false
createdAt
string | null
When the server was registered (ISO-8601). Absent on platform-owned servers, which are not stored per tenant.
Example:
"2026-08-10T14:32:05Z"
updatedAt
string | null
When it last changed (ISO-8601). Absent until the first change.
Example:
"2026-08-10T18:20:41Z"
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cloud Chat","colors":{"primary":"#EF7221","light":"#FF9D5C","dark":"#D65E10"},"logo":{"light":"https://mintcdn.com/cloud-humans/GHbxWTY81Qa4762I/logo/light.svg?fit=max\u0026auto=format\u0026n=GHbxWTY81Qa4762I\u0026q=85\u0026s=2899d32cd5c5f8adff5bb4390125f626","dark":"https://mintcdn.com/cloud-humans/GHbxWTY81Qa4762I/logo/dark.svg?fit=max\u0026auto=format\u0026n=GHbxWTY81Qa4762I\u0026q=85\u0026s=95d8350f3dade95801b6c310d5ba597f"},"favicon":"https://mintcdn.com/cloud-humans/T7XxBi09ex74abIC/favicon.svg?fit=max\u0026auto=format\u0026n=T7XxBi09ex74abIC\u0026q=85\u0026s=6b1379d1ea0f266d6ca12eb1f8ccbf77","fonts":{"family":"Inter"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloud-humans","hasAudioNarration":false,"actualSubdomain":"cloud-humans","customDomains":["docs.cloudhumans.com"],"gitSource":{"type":"github","owner":"cloudhumans","repo":"dev-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aff212b5735af7f41d07425","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API Reference","count":190},{"language":"default","tag":"Cloud Chat","count":129},{"language":"default","tag":"Claudia","count":66},{"language":"default","tag":"Guides","count":32},{"language":"default","tag":"Data Export","count":27},{"language":"default","tag":"Table Catalog","count":19},{"language":"default","tag":"Agents","count":18},{"language":"default","tag":"Help Center","count":15},{"language":"default","tag":"Conversations","count":14},{"language":"default","tag":"Controlled Flows","count":14}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/claudia/v1/mcp-servers/register-an-mcp-server","slug":"/api-reference/claudia/v1/mcp-servers/register-an-mcp-server","pageMetadata":{"title":"Register an MCP server","description":"Add a server so its tools become available to this tenant's agents. Probe the endpoint with validateMcpServer first: a passing probe is what lets you send `verified: true`, which is what makes the runtime call the url exactly as you wrote it.","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json post /v1/tenants/{tenant}/mcp-servers","href":"/api-reference/claudia/v1/mcp-servers/register-an-mcp-server","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Add a server so its tools become available to this tenant’s agents. Probe the endpoint with validateMcpServer first: a passing probe is what lets you send \", _jsx(_components.code, {\n children: \"verified: true\"\n }), \", which is what makes the runtime call the url exactly as you wrote it.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Register an MCP server","description":"Add a server so its tools become available to this tenant's agents. Probe the endpoint with validateMcpServer first: a passing probe is what lets you send `verified: true`, which is what makes the runtime call the url exactly as you wrote it.","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json post /v1/tenants/{tenant}/mcp-servers","href":"/api-reference/claudia/v1/mcp-servers/register-an-mcp-server","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["MCP Servers"],"summary":"Register an MCP server","description":"Add a server so its tools become available to this tenant's agents. Probe the endpoint with validateMcpServer first: a passing probe is what lets you send `verified: true`, which is what makes the runtime call the url exactly as you wrote it.","operationId":"createMcpServer","parameters":["0cd23072-9adb-46dc-949d-d6cfb156d8bc"],"requestBody":"b07639bc-2bc8-43fc-9edb-b28ca6bb49a6","responses":{"201":"401728d9-bada-477b-87a9-2e81fa7f84c2","400":"06909533-3082-46b5-af77-1810359f0093","401":"d278aba2-81bd-4281-804e-dfc91997b58b","403":"44b14086-f722-424f-827a-ddef53ec9615","404":"dce16c1c-9161-412c-9c72-0378e2b9d7a9","409":"bb461cec-598c-4eef-a181-19f213fa5e68","429":"e8d212bf-4ca8-4c85-9cd7-7b64138c99de"},"method":"post","type":"path","servers":["557d7370-1f8d-4b04-9769-2524f2a2a84b","47fbe982-01c5-4c8b-9eb6-0cd8bca9a131"],"security":["a9ad52c1-41e3-4548-96fa-4155550eb294"],"path":"/v1/tenants/{tenant}/mcp-servers","baseUrlOptions":["https://api.cloudhumans.com/claudia","https://api.cloudhumans.com/claudia/staging"],"title":"Register an MCP server","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"0cd23072-9adb-46dc-949d-d6cfb156d8bc":{"name":"tenant","in":"path","description":"Tenant whose MCP servers you are managing. Get it from the backoffice `GET /auth/v1/me/claudia-projects`, which answers with the tenant your credentials cover. A tenant your credentials do not cover is indistinguishable from one that does not exist.","required":true,"schema":{"type":"string","isRequired":true,"description":"Tenant whose MCP servers you are managing. Get it from the backoffice `GET /auth/v1/me/claudia-projects`, which answers with the tenant your credentials cover. A tenant your credentials do not cover is indistinguishable from one that does not exist.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"required":["authType","name","url","verified"],"type":"object","properties":{"name":{"type":"string","description":"Display name. The slug agents reference is derived from it, so pick something stable.","example":"Acme Orders","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"url":{"type":"string","description":"The MCP endpoint, http or https. Sent as written — include the full path the server answers on (commonly ending in `/mcp`) and set `verified` after probing it.","example":"https://mcp.acme.com/mcp","isRequired":true,"uniqueKey":"url","typeLabel":"string"},"authType":{"type":"string","description":"How Claudia should authenticate. `bearer` and `apiKey` require `credentials`; `none`, `forwarded_user` and `oauth` require that it be omitted.","example":"bearer","enum":["none","bearer","apiKey","forwarded_user","oauth"],"isRequired":true,"uniqueKey":"authType","typeLabel":"enum\u003cstring>"},"verified":{"type":"boolean","description":"Whether the url is a complete MCP endpoint. Set true only after validateMcpServer answered `valid: true` for this exact url, auth type, credential and headers; leaving it false makes the runtime append `/mcp` to the url.","example":true,"isRequired":true,"uniqueKey":"verified","typeLabel":"boolean"},"credentials":{"type":"string","description":"The secret to authenticate with, in full. Stored encrypted and never returned. Required for `bearer` and `apiKey`, refused for every other auth type.","example":"sk-live-9f3c2b7a","uniqueKey":"credentials","typeLabel":"string"},"customHeaders":{"type":"object","additionalProperties":{"type":"string","description":"Extra headers to send on every call. Names are lowercased on save; reserved names are dropped rather than rejected.","example":"{\"x-acme-region\":\"br\"}","uniqueKey":"customHeaders.additionalProperties","typeLabel":"string"},"description":"Extra headers to send on every call. Names are lowercased on save; reserved names are dropped rather than rejected.","example":{"x-acme-region":"br"},"uniqueKey":"customHeaders","typeLabel":"object"}},"description":"The MCP server to register.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"Acme Orders","url":"https://mcp.acme.com/mcp","authType":"bearer","verified":true,"credentials":"sk-live-9f3c2b7a","customHeaders":{"x-acme-region":"br"}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"401728d9-bada-477b-87a9-2e81fa7f84c2":{"description":"The server as registered.","content":{"application/json":{"schema":{"required":["authType","credentialsStored","customHeaders","id","name","platformOwned","slug","url","verified"],"type":"object","properties":{"id":{"type":"string","description":"Use this id to update, delete or re-probe this server.","example":"6683f1c2a4b19e0012ab34cd","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"name":{"type":"string","description":"Display name, as shown in the Tools screen.","example":"Acme Orders","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"slug":{"type":"string","description":"Stable key derived from the name: lowercased, with every run of non-alphanumeric characters collapsed into `_`. Agent configurations reference a server by this key, so renaming a server changes it and is not a cosmetic edit. Unique within the tenant.","example":"acme_orders","isRequired":true,"uniqueKey":"slug","typeLabel":"string"},"url":{"type":"string","description":"The MCP endpoint agents call. Used exactly as stored once `verified` is true.","example":"https://mcp.acme.com/mcp","isRequired":true,"uniqueKey":"url","typeLabel":"string"},"authType":{"type":"string","description":"How Claudia authenticates to this server. `none` sends no credential; `bearer` sends the stored secret as `Authorization: Bearer \u003csecret>`; `apiKey` sends it as `x-api-key`; `forwarded_user` stores no secret and forwards the end user's own token at call time; `oauth` stores no secret either and lets the CloudHumans MCP gateway resolve the contact's custodied session.","example":"bearer","enum":["none","bearer","apiKey","forwarded_user","oauth"],"isRequired":true,"uniqueKey":"authType","typeLabel":"enum\u003cstring>"},"credentialsStored":{"type":"boolean","description":"Whether a secret is stored for this server. The secret itself is never returned by this API — to change it, send the new value in full. Always false for `none`, `forwarded_user` and `oauth`, which store no secret by design, and for platform-owned servers, whose credential is held by the platform.","example":true,"isRequired":true,"uniqueKey":"credentialsStored","typeLabel":"boolean"},"customHeaders":{"type":"object","additionalProperties":{"type":"string","description":"Extra headers sent on every call to this server. Header names are lowercased on save, and the ones owned by the auth and tenant pipeline (`authorization`, `x-api-key`, `x-tenant`, `x-authorization`, `x-account`, `x-tenant-name`) are dropped — send credentials through `credentials`, not here.","example":"{\"x-acme-region\":\"br\"}","uniqueKey":"customHeaders.additionalProperties","typeLabel":"string"},"description":"Extra headers sent on every call to this server. Header names are lowercased on save, and the ones owned by the auth and tenant pipeline (`authorization`, `x-api-key`, `x-tenant`, `x-authorization`, `x-account`, `x-tenant-name`) are dropped — send credentials through `credentials`, not here.","example":{"x-acme-region":"br"},"isRequired":true,"uniqueKey":"customHeaders","typeLabel":"object"},"verified":{"type":"boolean","description":"Whether this url was probed successfully and is used as stored. False keeps the legacy behaviour of appending `/mcp` to the url at call time, so a server whose url already ends in the MCP path answers 404 until it is verified.","example":true,"isRequired":true,"uniqueKey":"verified","typeLabel":"boolean"},"platformOwned":{"type":"boolean","description":"Whether CloudHumans owns this server. Platform-owned servers are provided to every tenant and are listed so agents can reference them, but they cannot be changed or deleted — those attempts answer 422.","example":false,"isRequired":true,"uniqueKey":"platformOwned","typeLabel":"boolean"},"createdAt":{"oneOf":[{"type":"string","description":"When the server was registered (ISO-8601). Absent on platform-owned servers, which are not stored per tenant.","example":"2026-08-10T14:32:05Z","uniqueKey":"createdAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"When the server was registered (ISO-8601). Absent on platform-owned servers, which are not stored per tenant.","example":"2026-08-10T14:32:05Z","uniqueKey":"createdAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"createdAt","typeLabel":"string | null"},"updatedAt":{"oneOf":[{"type":"string","description":"When it last changed (ISO-8601). Absent until the first change.","example":"2026-08-10T18:20:41Z","uniqueKey":"updatedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"When it last changed (ISO-8601). Absent until the first change.","example":"2026-08-10T18:20:41Z","uniqueKey":"updatedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"updatedAt","typeLabel":"string | null"}},"description":"An MCP server your agents can call tools on.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"6683f1c2a4b19e0012ab34cd","name":"Acme Orders","slug":"acme_orders","url":"https://mcp.acme.com/mcp","authType":"bearer","credentialsStored":true,"customHeaders":{"x-acme-region":"br"},"verified":true,"platformOwned":false,"createdAt":"2026-08-10T14:32:05Z","updatedAt":"2026-08-10T18:20:41Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"06909533-3082-46b5-af77-1810359f0093":{"description":"The request could not be answered as written.","content":{"application/json":{"schema":{"required":["error"],"type":"object","properties":{"error":{"type":"string","description":"What went wrong.","example":"Forbidden: token holds no claim for the requested account","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"description":"Something the caller needs to fix.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Forbidden: token holds no claim for the requested account"}}},"exampleType":"generated"}},"exampleType":"generated"},"d278aba2-81bd-4281-804e-dfc91997b58b":{"description":"Missing, expired or invalid credentials.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"44b14086-f722-424f-827a-ddef53ec9615":{"description":"The credentials hold no account allowed to manage this content.","content":{"application/json":{"schema":{"required":["error"],"type":"object","properties":{"error":{"type":"string","description":"What went wrong.","example":"Forbidden: token holds no claim for the requested account","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"description":"Something the caller needs to fix.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Forbidden: token holds no claim for the requested account"}}},"exampleType":"generated"}},"exampleType":"generated"},"dce16c1c-9161-412c-9c72-0378e2b9d7a9":{"description":"No such resource, or none these credentials can reach — the two are deliberately indistinguishable.","content":{"application/json":{"schema":{"required":["error"],"type":"object","properties":{"error":{"type":"string","description":"What went wrong.","example":"Forbidden: token holds no claim for the requested account","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"description":"Something the caller needs to fix.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Forbidden: token holds no claim for the requested account"}}},"exampleType":"generated"}},"exampleType":"generated"},"bb461cec-598c-4eef-a181-19f213fa5e68":{"description":"Another server on this tenant already resolves to the same slug. Pick a different name.","content":{"application/json":{"schema":{"required":["error"],"type":"object","properties":{"error":{"type":"string","description":"What went wrong.","example":"Forbidden: token holds no claim for the requested account","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"description":"Something the caller needs to fix.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Forbidden: token holds no claim for the requested account"}}},"exampleType":"generated"}},"exampleType":"generated"},"e8d212bf-4ca8-4c85-9cd7-7b64138c99de":{"description":"Rate limit applied by the API gateway. Back off and retry.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"a9ad52c1-41e3-4548-96fa-4155550eb294":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"557d7370-1f8d-4b04-9769-2524f2a2a84b":{"url":"https://api.cloudhumans.com/claudia","description":"Production"},"47fbe982-01c5-4c8b-9eb6-0cd8bca9a131":{"url":"https://api.cloudhumans.com/claudia/staging","description":"Staging"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/specs/claudia/v1.json"},"subdomain":"cloud-humans","siteName":"Cloud Chat","title":"Register an MCP server - Cloud Chat","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T20:16:56.566Z","originalFileLocation":"api-reference/claudia/v1/mcp-servers/register-an-mcp-server.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Add a server so its tools become available to this tenant\u0026#x27;s agents. Probe the endpoint with validateMcpServer first: a passing probe is what lets you send verified: true, which is what makes the runtime call the url exactly as you wrote it.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cloud Chat\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloud-humans/Tjh_1uQRibuZjdTW/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cloud-humans/Tjh_1uQRibuZjdTW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloud-humans/Tjh_1uQRibuZjdTW/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloud-humans/Tjh_1uQRibuZjdTW/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloud-humans/Tjh_1uQRibuZjdTW/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloud-humans/Tjh_1uQRibuZjdTW/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloud-humans/Tjh_1uQRibuZjdTW/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloud-humans/Tjh_1uQRibuZjdTW/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloud-humans/Tjh_1uQRibuZjdTW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Register an MCP server - Cloud Chat\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add a server so its tools become available to this tenant\u0026#x27;s agents. Probe the endpoint with validateMcpServer first: a passing probe is what lets you send verified: true, which is what makes the runtime call the url exactly as you wrote it.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cloud Chat\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloudhumans.com/api-reference/claudia/v1/mcp-servers/register-an-mcp-server\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloud-humans.mintlify.site/_mintlify/api/og/v2?division=MCP+Servers\u0026amp;title=Register+an+MCP+server\u0026amp;description=Add+a+server+so+its+tools+become+available+to+this+tenant%27s+agents.+Probe+the+endpoint+with+validateMcpServer+first%3A+a+passing+probe+is+what+lets+you+send+%60veri\u0026amp;theme=f1ab87c694400f10daae88f8\u0026amp;signature=c47cce4f7f5b6c2c92f8cb6dc73e871fc660dd5a3dfd1deda9476f850432c5de\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Register an MCP server - Cloud Chat\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add a server so its tools become available to this tenant\u0026#x27;s agents. Probe the endpoint with validateMcpServer first: a passing probe is what lets you send verified: true, which is what makes the runtime call the url exactly as you wrote it.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloud-humans.mintlify.site/_mintlify/api/og/v2?division=MCP+Servers\u0026amp;title=Register+an+MCP+server\u0026amp;description=Add+a+server+so+its+tools+become+available+to+this+tenant%27s+agents.+Probe+the+endpoint+with+validateMcpServer+first%3A+a+passing+probe+is+what+lets+you+send+%60veri\u0026amp;theme=f1ab87c694400f10daae88f8\u0026amp;signature=c47cce4f7f5b6c2c92f8cb6dc73e871fc660dd5a3dfd1deda9476f850432c5de\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cloud-humans/Tjh_1uQRibuZjdTW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cloud Chat\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#EF7221\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloudhumans.com/api-reference/claudia/v1/mcp-servers/register-an-mcp-server\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/claudia/v1/mcp-servers/register-an-mcp-server.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloudhumans.com/#organization\",\"name\":\"Cloud Chat\",\"url\":\"https://docs.cloudhumans.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloud-humans/GHbxWTY81Qa4762I/logo/light.svg?fit=max\u0026auto=format\u0026n=GHbxWTY81Qa4762I\u0026q=85\u0026s=2899d32cd5c5f8adff5bb4390125f626\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloudhumans.com#website\",\"name\":\"Cloud Chat\",\"url\":\"https://docs.cloudhumans.com\",\"publisher\":{\"@id\":\"https://docs.cloudhumans.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloudhumans.com/api-reference/claudia/v1/mcp-servers/register-an-mcp-server#webpage\",\"url\":\"https://docs.cloudhumans.com/api-reference/claudia/v1/mcp-servers/register-an-mcp-server\",\"name\":\"Register an MCP server\",\"description\":\"Add a server so its tools become available to this tenant's agents. Probe the endpoint with validateMcpServer first: a passing probe is what lets you send verified: true, which is what makes the runtime call the url exactly as you wrote it.\",\"dateModified\":\"2026-11-18T20:16:56.566Z\",\"isPartOf\":{\"@id\":\"https://docs.cloudhumans.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloudhumans.com/api-reference/claudia/v1/mcp-servers/register-an-mcp-server#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloudhumans.com/api-reference/claudia/v1/mcp-servers/register-an-mcp-server#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"MCP Servers\",\"item\":\"https://docs.cloudhumans.com/api-reference/claudia/v1/mcp-servers/list-mcp-servers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Register an MCP server\",\"item\":\"https://docs.cloudhumans.com/api-reference/claudia/v1/mcp-servers/register-an-mcp-server\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.cloudhumans.com/api-reference/claudia/v1/mcp-servers/register-an-mcp-server#apireference\",\"headline\":\"Register an MCP server\",\"name\":\"Register an MCP server\",\"description\":\"Add a server so its tools become available to this tenant's agents. Probe the endpoint with validateMcpServer first: a passing probe is what lets you send verified: true, which is what makes the runtime call the url exactly as you wrote it.\",\"url\":\"https://docs.cloudhumans.com/api-reference/claudia/v1/mcp-servers/register-an-mcp-server\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloudhumans.com/api-reference/claudia/v1/mcp-servers/register-an-mcp-server#webpage\"},\"dateModified\":\"2026-11-18T20:16:56.566Z\",\"publisher\":{\"@id\":\"https://docs.cloudhumans.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloudhumans.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cloud Chat\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cloud Chat\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/claudia/v1/mcp-servers/register-an-mcp-server.md","siteName":"Cloud Chat","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","products":[{"product":"Cloud Chat","icon":"messages","pages":[{"title":"Cloud Chat","href":"/api-reference/cloudchat/overview"}]},{"product":"Claudia","icon":"robot","groups":[{"group":"Getting Started","pages":[{"title":"Sign in","href":"/api-reference/claudia/sign-in"},{"title":"API credentials","href":"/api-reference/claudia/api-credentials"}]},{"group":"Authentication","pages":[{"title":"Sign in and get a token","deprecated":null,"version":null,"openapi":"/api-reference/specs/auth/v1.json post /v1/signin","href":"/api-reference/claudia/v1/auth/authentication/sign-in-and-get-a-token"},{"title":"Answer a sign-in challenge","deprecated":null,"version":null,"openapi":"/api-reference/specs/auth/v1.json post /v1/signin/challenge","href":"/api-reference/claudia/v1/auth/authentication/answer-a-sign-in-challenge"}]},{"group":"Agents","pages":[{"title":"List agents","openapi":"api-reference/specs/claudia/v1.json GET /v1/tenants/{tenant}/assistants","href":"/api-reference/claudia/endpoints/list-assistants"},{"title":"Get one agent","openapi":"api-reference/specs/claudia/v1.json GET /v1/tenants/{tenant}/assistants/{id}","href":"/api-reference/claudia/endpoints/get-assistant"},{"title":"List an agent's saved versions","openapi":"api-reference/specs/claudia/v1.json GET /v1/tenants/{tenant}/assistants/{id}/versions","href":"/api-reference/claudia/endpoints/list-assistant-versions"},{"title":"Get one saved version of an agent","openapi":"api-reference/specs/claudia/v1.json GET /v1/tenants/{tenant}/assistants/{id}/versions/{version}","href":"/api-reference/claudia/endpoints/get-assistant-version"},{"title":"Create an agent","openapi":"api-reference/specs/claudia/v1.json POST /v1/tenants/{tenant}/assistants","href":"/api-reference/claudia/endpoints/create-assistant"},{"title":"Read one prompt field's full text","openapi":"api-reference/specs/claudia/v1.json POST /v1/tenants/{tenant}/assistants/{id}/text","href":"/api-reference/claudia/endpoints/read-assistant-text"},{"title":"Propose an agent edit","openapi":"api-reference/specs/claudia/v1.json POST /v1/tenants/{tenant}/assistants/{id}/propose-edits","href":"/api-reference/claudia/endpoints/propose-assistant-edits"},{"title":"Confirm an agent edit","openapi":"api-reference/specs/claudia/v1.json POST /v1/tenants/{tenant}/assistants/{id}/confirm-edits","href":"/api-reference/claudia/endpoints/confirm-assistant-edits"},{"title":"Propose an agent create","openapi":"api-reference/specs/claudia/v1.json POST /v1/tenants/{tenant}/assistants/propose-create","href":"/api-reference/claudia/endpoints/propose-assistant-create"},{"title":"Confirm an agent create","openapi":"api-reference/specs/claudia/v1.json POST /v1/tenants/{tenant}/assistants/confirm-create","href":"/api-reference/claudia/endpoints/confirm-assistant-create"},{"title":"Delete a draft agent","openapi":"api-reference/specs/claudia/v1.json DELETE /v1/tenants/{tenant}/assistants/{id}","href":"/api-reference/claudia/endpoints/delete-assistant"},{"title":"Chat with one agent in a test conversation","openapi":"api-reference/specs/claudia/v1.json POST /v1/tenants/{tenant}/assistants/{id}/invoke","href":"/api-reference/claudia/endpoints/invoke-assistant"}]},{"group":"Agent Tools","pages":[{"title":"List agent tools","openapi":"api-reference/specs/claudia/v1.json GET /v1/tenants/{tenant}/agent-tools","href":"/api-reference/claudia/endpoints/list-agent-tools"}]},{"group":"Conversations","pages":[{"title":"Get a conversation summary","openapi":"api-reference/specs/claudia/v1.json GET /v1/conversations/{id}/summary","href":"/api-reference/claudia/endpoints/get-conversation-summary"},{"title":"Get a message's execution trace","openapi":"api-reference/specs/claudia/v1.json GET /v1/messages/{messageId}/trace","href":"/api-reference/claudia/endpoints/get-message-trace"}]},{"group":"Knowledge Bases","pages":[{"title":"List knowledge bases","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json get /v1/knowledge-bases","href":"/api-reference/claudia/v1/knowledge-bases/list-knowledge-bases"},{"title":"Get a knowledge base","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json get /v1/knowledge-bases/{kbId}","href":"/api-reference/claudia/v1/knowledge-bases/get-a-knowledge-base"},{"title":"Create a knowledge base","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json post /v1/knowledge-bases","href":"/api-reference/claudia/v1/knowledge-bases/create-a-knowledge-base"}]},{"group":"Knowledge Base Content","pages":[{"title":"List and search content","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json get /v1/knowledge-bases/{kbId}/entries","href":"/api-reference/claudia/v1/knowledge-base-content/list-and-search-content"},{"title":"Get a content entry","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json get /v1/knowledge-bases/{kbId}/entries/{entryId}","href":"/api-reference/claudia/v1/knowledge-base-content/get-a-content-entry"},{"title":"List tags in use","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json get /v1/knowledge-bases/{kbId}/entries/tags","href":"/api-reference/claudia/v1/knowledge-base-content/list-tags-in-use"},{"title":"List topics in use","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json get /v1/knowledge-bases/{kbId}/entries/topics","href":"/api-reference/claudia/v1/knowledge-base-content/list-topics-in-use"},{"title":"Create a content entry","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json post /v1/knowledge-bases/{kbId}/entries","href":"/api-reference/claudia/v1/knowledge-base-content/create-a-content-entry"},{"title":"Import content in bulk","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json post /v1/knowledge-bases/{kbId}/entries/import","href":"/api-reference/claudia/v1/knowledge-base-content/import-content-in-bulk"},{"title":"Enable or disable an entry","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json post /v1/knowledge-bases/{kbId}/entries/{entryId}/toggle-disable","href":"/api-reference/claudia/v1/knowledge-base-content/enable-or-disable-an-entry"},{"title":"Update a content entry","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json put /v1/knowledge-bases/{kbId}/entries/{entryId}","href":"/api-reference/claudia/v1/knowledge-base-content/update-a-content-entry"},{"title":"Delete a content entry","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json delete /v1/knowledge-bases/{kbId}/entries/{entryId}","href":"/api-reference/claudia/v1/knowledge-base-content/delete-a-content-entry"}]},{"group":"Content Quality","pages":[{"title":"List proposed rewrites","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json get /v1/knowledge-bases/{kbId}/improvements/quality","href":"/api-reference/claudia/v1/content-quality/list-proposed-rewrites"},{"title":"Count the quality review","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json get /v1/knowledge-bases/{kbId}/improvements/quality/summary","href":"/api-reference/claudia/v1/content-quality/count-the-quality-review"},{"title":"Approve proposed rewrites","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json post /v1/knowledge-bases/{kbId}/improvements/quality/approve","href":"/api-reference/claudia/v1/content-quality/approve-proposed-rewrites"},{"title":"Reject proposed rewrites","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json post /v1/knowledge-bases/{kbId}/improvements/quality/reject","href":"/api-reference/claudia/v1/content-quality/reject-proposed-rewrites"},{"title":"Edit a proposal before approving it","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json put /v1/knowledge-bases/{kbId}/improvements/quality/{id}","href":"/api-reference/claudia/v1/content-quality/edit-a-proposal-before-approving-it"}]},{"group":"Content Improvements","pages":[{"title":"List suggested content","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json get /v1/knowledge-bases/{kbId}/improvements","href":"/api-reference/claudia/v1/content-improvements/list-suggested-content"},{"title":"Count the review queue","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json get /v1/knowledge-bases/{kbId}/improvements/summary","href":"/api-reference/claudia/v1/content-improvements/count-the-review-queue"},{"title":"Approve suggestions","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json post /v1/knowledge-bases/{kbId}/improvements/approve","href":"/api-reference/claudia/v1/content-improvements/approve-suggestions"},{"title":"Reject suggestions","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json post /v1/knowledge-bases/{kbId}/improvements/reject","href":"/api-reference/claudia/v1/content-improvements/reject-suggestions"},{"title":"Edit a suggestion before approving it","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json put /v1/knowledge-bases/{kbId}/improvements/{entryId}","href":"/api-reference/claudia/v1/content-improvements/edit-a-suggestion-before-approving-it"}]},{"group":"Content Sources","pages":[{"title":"List content sources","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json get /v1/knowledge-bases/{kbId}/scraper-config","href":"/api-reference/claudia/v1/content-sources/list-content-sources"},{"title":"Create or update a content source","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json patch /v1/knowledge-bases/{kbId}/scraper-config","href":"/api-reference/claudia/v1/content-sources/create-or-update-a-content-source"},{"title":"Delete a content source","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json delete /v1/knowledge-bases/{kbId}/scraper-config/{configId}","href":"/api-reference/claudia/v1/content-sources/delete-a-content-source"},{"title":"Run a content source now","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json post /v1/knowledge-bases/{kbId}/scraper-config/{configId}/run","href":"/api-reference/claudia/v1/content-sources/run-a-content-source-now"}]},{"group":"MCP Servers","pages":[{"title":"List MCP servers","description":"Every MCP server registered for this tenant, including the ones CloudHumans provides to everyone. Start here: the ids returned are what the update, delete and probe operations take. Credentials are never part of the answer — `credentialsStored` only says whether one is on file.","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json get /v1/tenants/{tenant}/mcp-servers","href":"/api-reference/claudia/v1/mcp-servers/list-mcp-servers"},{"title":"Register an MCP server","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json post /v1/tenants/{tenant}/mcp-servers","href":"/api-reference/claudia/v1/mcp-servers/register-an-mcp-server"},{"title":"Probe an MCP server","description":"Ask a server for its tool list, with the same call the agent runtime makes, and report what happened. Nothing is registered or changed. Use it before createMcpServer to check an endpoint and its credential, and afterwards with `serverId` to check whether a server you already registered is still answering.","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json post /v1/tenants/{tenant}/mcp-servers/validate","href":"/api-reference/claudia/v1/mcp-servers/probe-an-mcp-server"},{"title":"Update an MCP server","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json put /v1/tenants/{tenant}/mcp-servers/{id}","href":"/api-reference/claudia/v1/mcp-servers/update-an-mcp-server"},{"title":"Delete an MCP server","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json delete /v1/tenants/{tenant}/mcp-servers/{id}","href":"/api-reference/claudia/v1/mcp-servers/delete-an-mcp-server"}]},{"group":"Playground","pages":[{"title":"Send a message to ClaudIA and read its answer","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json post /v1/playground/invoke","href":"/api-reference/claudia/v1/playground/send-a-message-to-claudia-and-read-its-answer"}]},{"group":"Project Settings","pages":[{"title":"Read a project's settings","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json get /v1/projects/{project}/settings","href":"/api-reference/claudia/v1/project-settings/read-a-projects-settings"},{"title":"Read who changed a project's settings, and to what","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json get /v1/projects/{project}/settings/history","href":"/api-reference/claudia/v1/project-settings/read-who-changed-a-projects-settings-and-to-what"},{"title":"Change a project's settings","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json patch /v1/projects/{project}/settings","href":"/api-reference/claudia/v1/project-settings/change-a-projects-settings"},{"title":"List a project's A/B variants","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json get /v1/projects/{project}/ab-keys","href":"/api-reference/claudia/v1/project-settings/list-a-projects-ab-variants"},{"title":"Read a project's A/B test","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json get /v1/projects/{project}/ab-test","href":"/api-reference/claudia/v1/ab-tests/read-a-projects-ab-test"},{"title":"Create or change an A/B variant","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json patch /v1/projects/{project}/ab-test/variants/{key}","href":"/api-reference/claudia/v1/ab-tests/create-or-change-an-ab-variant"},{"title":"Split new conversations between the base and the variants","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json put /v1/projects/{project}/ab-test/traffic","href":"/api-reference/claudia/v1/ab-tests/split-new-conversations-between-the-base-and-the-variants"},{"title":"Delete an A/B variant","deprecated":null,"version":null,"openapi":"/api-reference/specs/claudia/v1.json delete /v1/projects/{project}/ab-test/variants/{key}","href":"/api-reference/claudia/v1/ab-tests/delete-an-ab-variant"}]}]},{"product":"Controlled Flows","icon":"diagram-project","pages":[{"title":"Controlled Flows","href":"/api-reference/controlled-flows/overview"}]}]}]},"basePath":"","title":"Register an MCP server - Cloud Chat","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}