Crear MCP

Permite crear un MCP en una organización específica y obtener las tools expuestas por el MCP Server.

Mediante esta interfaz, se puede crear un MCP en una organización específica y obtener las tools expuestas por el MCP Server.

Método de solicitud

POST

URL de la solicitud

https://api.${endpoint}/v1/org/mcp/create

Autenticación de la solicitud

Utiliza la autenticación Basic con DevKey / DevSecret a nivel de cuenta y requiere que la cuenta que realiza la llamada tenga permiso de creación de MCP de la organización.

Solicitud

Ejemplo de solicitud

curl -X POST 'https://api.${endpoint}/v1/org/mcp/create' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -H 'Content-Type: application/json' \ -d '{ "org_id": "p-xxxx", "name": "crm-mcp", "display_name": "CRM MCP", "description": "CRM MCP server", "logo": "https://cdn.example.com/mcp.png", "url": "https://mcp.example.com/sse", "show_request": true, "mcp_transport_type": "SSE", "headers": [{"key": "Authorization", "value": "Bearer token"}], "queries": [{"key": "tenant", "value": "demo"}] }'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/mcp/create' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{
    "org_id": "p-xxxx",
    "name": "crm-mcp",
    "display_name": "CRM MCP",
    "description": "CRM MCP server",
    "logo": "https://cdn.example.com/mcp.png",
    "url": "https://mcp.example.com/sse",
    "show_request": true,
    "mcp_transport_type": "SSE",
    "headers": [{"key": "Authorization", "value": "Bearer token"}],
    "queries": [{"key": "tenant", "value": "demo"}]
  }'

Este bloque de código en una ventana flotante

Cabeceras de la solicitud

Campo	Tipo	Descripción
Authorization	Basic ${BASIC_TOKEN}	Basic Token resultante de codificar `DevKey:DevSecret` en Base64.
Content-Type	application/json	Formato del cuerpo de la solicitud.

Parámetros de la solicitud (Body Parameters)

Campo	Tipo	Descripción	Obligatorio
org_id	String	ID de la organización.	true
name	String	Nombre del MCP, hasta 20 caracteres.	true
display_name	String	Nombre de visualización del MCP, hasta 50 caracteres.	false
description	String	Descripción del MCP, hasta 100 caracteres.	true
logo	String	URL del icono del MCP.	true
url	String	URL del MCP Server, debe ser una dirección pública `http/https`.	true
show_request	Boolean	Indica si se muestra el contenido de la solicitud durante la invocación.	true
mcp_transport_type	String	Tipo de transporte del MCP; admite `SSE`, `STREAMABLE_HTTP`.	true
headers	Object[]	Cabeceras de la solicitud del MCP, hasta 10 entradas; cada una contiene `key` y `value`.	false
queries	Object[]	Parámetros de consulta del MCP, hasta 30 entradas; cada uno contiene `key` y `value`.	false

Respuesta

Ejemplo de respuesta

{ "code": 0, "message": "OK", "data": { "mcp_id": "mcp-xxxx", "available": true, "action_count": 3 } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "mcp_id": "mcp-xxxx",
    "available": true,
    "action_count": 3
  }
}

Este bloque de código en una ventana flotante

Respuesta correcta

Campo	Tipo	Descripción
mcp_id	String	ID del MCP recién creado.
available	Boolean	Indica si el MCP está disponible.
action_count	Integer	Número de Actions obtenidas.

Respuesta fallida

Campo	Tipo	Descripción
code	Integer	Código de error.
message	String	Detalles del error.

Códigos de estado

Código de estado	Descripción
200	Correcto
400	Error de parámetros
401	No autorizado
403	Permisos insuficientes
429	Demasiadas solicitudes
500	Error del servidor