Saltar para o conteúdo principal
POST
/
public
/
api
/
v1
/
agents
/
{agentPublicId}
/
external-mcps
Link an External MCP server to the agent
curl --request POST \
  --url https://api.gennia.ai/public/api/v1/agents/{agentPublicId}/external-mcps \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "externalMcpPublicId": "9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21",
  "instanceMode": "STATIC"
}
'
{
  "active": true,
  "externalMcpPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requiresApproval": true,
  "serverName": "<string>",
  "serverUrl": "<string>"
}

Autorizações

​
X-Api-Key
string
header
obrigatório

Parâmetros de caminho

​
agentPublicId
string<uuid>
obrigatório

Corpo

application/json

Body for linking an existing external MCP server to an agent.

​
externalMcpPublicId
string<uuid>
obrigatório

Public ID of the external MCP server to link.

Exemplo:

"9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21"

​
instanceMode
enum<string>

Instance mode controlling whether the MCP is shared across calls (STATIC) or instantiated per call (DYNAMIC).

Opções disponíveis:
STATIC,
DYNAMIC
Pattern: ^(STATIC|DYNAMIC)$
Exemplo:

"STATIC"

Resposta

Server linked

External MCP server linked to an agent.

​
active
boolean
​
externalMcpPublicId
string<uuid>
​
instanceMode
enum<string>
Opções disponíveis:
STATIC,
DYNAMIC
​
requiresApproval
boolean
​
serverName
string
​
serverUrl
string