SpainMCP
Referencia APIConnect

Crear o actualizar conexion

Crea o actualiza (upsert) una conexion MCP gestionada.

PUT /connections/{namespace}/{connectionId}

Autorizaciones

ParametroTipoUbicacionRequeridoDescripcion
AuthorizationstringheadersiAPI key de SpainMCP como Bearer token

Parametros de Ruta

ParametroTipoRequeridoDescripcion
namespacestringsiNamespace de la conexion (p.ej. 'myorg')
connectionIdstringsiIdentificador unico de la conexion

Body

application/json

CampoTipoRequeridoEjemplo
mcpUrlstringsi"https://mcp.example.com/sse"
namestringno"Mi servidor MCP"
metadataobjectno{ "env": "production" }
headersobjectno{ "X-Custom": "value" }

Respuesta

200application/json — Conexion creada o actualizada correctamente

CampoTipoRequeridoEjemplo
connectionIdstringsi"my-connection"
statusstringsi"connected"
authorizationUrlstring | nullsinull
serverInfoobject | nullsi

El campo status puede tomar los valores "connected", "auth_required" o "error".

{
  "connectionId": "my-connection",
  "status": "connected",
  "authorizationUrl": null,
  "serverInfo": {
    "name": "Mi servidor MCP",
    "version": "1.0.0",
    "tools": ["buscar", "consultar"]
  }
}

Ejemplo

import SpainMCP from '@spainmcp/api';

const client = new SpainMCP({
  apiKey: process.env['SPAINMCP_API_KEY'],
});

const connection = await client.connections.update('myorg', 'my-connection', {
  mcpUrl: 'https://mcp.example.com/sse',
  name: 'Mi servidor MCP actualizado',
  metadata: { env: 'staging' },
});

console.log(connection.status);
¿Te ha sido útil esta página?

En esta página