Saltar para o conteúdo principal
PATCH
/
public
/
api
/
v1
/
external-mcps
/
{externalMcpPublicId}
Update an External MCP server
curl --request PATCH \
  --url https://api.gennia.ai/public/api/v1/external-mcps/{externalMcpPublicId} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "authHeaderName": "X-Api-Key",
  "authHeaders": [
    {}
  ],
  "authValue": "sk_live_abc123",
  "name": "GitHub MCP",
  "url": "https://mcp.example.com/sse"
}
'
{
  "authHeaderName": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "errorMessage": "<string>",
  "lastDiscoveredAt": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "publicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "tools": [
    {}
  ],
  "updatedAt": "2023-11-07T05:31:56Z",
  "url": "<string>"
}

Autorizações

​
X-Api-Key
string
header
obrigatório

Parâmetros de caminho

​
externalMcpPublicId
string<uuid>
obrigatório

Corpo

application/json

Body for updating an existing external MCP server. All fields are optional; only provided fields are updated.

​
authHeaderName
string

New legacy header name (prefer authHeaders for CUSTOM_HEADER).

Exemplo:

"X-Api-Key"

​
authHeaders
object[]

New list of custom auth headers, each as {name, value}.

​
authType
enum<string>

New authentication scheme used to talk to the MCP server.

Opções disponíveis:
NONE,
API_KEY,
BEARER_TOKEN,
CUSTOM_HEADER,
OAUTH_AUTHORIZATION_CODE
​
authValue
string

New credential value for API_KEY/BEARER_TOKEN auth.

Exemplo:

"sk_live_abc123"

​
name
string

New display name of the external MCP server.

Maximum string length: 255
Exemplo:

"GitHub MCP"

​
url
string

New HTTPS URL of the external MCP server.

Maximum string length: 2048
Pattern: ^https://.+
Exemplo:

"https://mcp.example.com/sse"

Resposta

OK

Workspace-registered External MCP server. Auth values are NEVER returned.

​
authHeaderName
string

Present when authType=CUSTOM_HEADER with a single legacy header.

​
authType
enum<string>
Opções disponíveis:
NONE,
API_KEY,
BEARER_TOKEN,
CUSTOM_HEADER
​
createdAt
string<date-time>
​
errorMessage
string
​
lastDiscoveredAt
string<date-time>
​
name
string
​
publicId
string<uuid>
​
status
enum<string>
Opções disponíveis:
PENDING,
CONNECTED,
ERROR,
PENDING_AUTHORIZATION,
EXPIRED
​
tools
object[]

Tools discovered on the server. {id,name,description,enabled}

​
updatedAt
string<date-time>
​
url
string