Saltar al contenido principal
StudioMeyer.
Volver al índice para desarrolladores

StudioMeyer MCP: conectar la documentación pública

El servidor de documentación en https://studiomeyer.io/api/docs/mcp ofrece solo documentación pública de lectura. No necesita clave API ni OAuth y no accede a datos de cuentas, Memory o checkout. Sus herramientas no envían datos de contacto ni reservan citas.

Conectar mediante Streamable HTTP

Añade https://studiomeyer.io/api/docs/mcp como URL MCP remota en un cliente compatible con Streamable HTTP. Deja las credenciales vacías. El cliente gestiona la inicialización y los mensajes del protocolo; el servidor funciona sin estado y devuelve respuestas JSON.

El endpoint admite POST y OPTIONS. Una petición GET simple no es una conexión MCP. Tras conectarte, consulta las herramientas disponibles con tools/list.

Exactamente dos herramientas de lectura

search acepta query como texto no vacío de hasta 200 caracteres y un limit opcional de 1 a 5, con valor predeterminado 5. El array results contiene id, title, url y snippet. Busca solo en los documentos públicos de StudioMeyer definidos, no en la web.

fetch acepta id: la ID exacta del documento o la URL canónica sin modificar de un resultado. Devuelve id, title, url y text. No recupera otros hosts, rutas privadas ni URL modificadas. Un documento desconocido produce un resultado de herramienta con isError: true.

Las llamadas correctas devuelven structuredContent y los mismos datos como JSON en un bloque de texto. Comprueba isError antes de usar el resultado.

Argumentos de search
{
  "query": "authentication",
  "limit": 5
}

Argumentos de fetch
{
  "id": "authentication"
}

Ejemplo completo con el SDK oficial de MCP

El ejemplo utiliza @modelcontextprotocol/sdk en la versión 1.32.2, no un SDK de StudioMeyer. Guarda el código JavaScript como docs-client.mjs en una carpeta de ejemplo independiente. Instala allí el paquete con los comandos de abajo y ejecuta el archivo con Node.js.

El cliente inicializa la conexión, lista las herramientas, busca documentación pública de autenticación y recupera el primer resultado con fetch. finally cierra el cliente incluso tras un error. No se transmiten datos de productos ni credenciales.

Instalar y ejecutar en la carpeta de ejemplo
npm init -y
npm install @modelcontextprotocol/sdk@1.32.2
node docs-client.mjs

docs-client.mjs
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({
  name: "studiomeyer-docs-example",
  version: "1.0.0"
});
const transport = new StreamableHTTPClientTransport(
  new URL("https://studiomeyer.io/api/docs/mcp")
);

try {
  await client.connect(transport);
  const tools = await client.listTools();
  console.log(tools.tools.map((tool) => tool.name));

  const search = await client.callTool({
    name: "search",
    arguments: { query: "authentication", limit: 5 }
  });
  if (search.isError) throw new Error(JSON.stringify(search.content));
  const results = search.structuredContent?.results;
  if (!Array.isArray(results) || typeof results[0]?.id !== "string") {
    throw new Error("No public document found");
  }

  const document = await client.callTool({
    name: "fetch",
    arguments: { id: results[0].id }
  });
  if (document.isError) throw new Error(JSON.stringify(document.content));
  console.log(document.structuredContent ?? document.content);
} finally {
  await client.close();
}

Siete documentos públicos de fuentes mantenidas

authentication corresponde a /auth.md: métodos de acceso y límites de cuentas. pricing corresponde a /pricing.md: precios publicados de webs y productos, desde las fuentes actuales. developer-index corresponde a /developers/llms.txt: interfaces y contratos relacionados.

integration-skill corresponde a /.well-known/agent-skills/studiomeyer-services/SKILL.md: la guía pública de integración. public-api corresponde a /api/v1/docs: documentación JSON de la API pública de la web. Los contenidos proceden de los mismos generadores que los documentos públicos correspondientes.

public-api-guide corresponde a https://studiomeyer.io/en/developers/api.md y mcp-guide a https://studiomeyer.io/en/developers/mcp.md. Estas guías usan el mismo contenido DE/EN/ES que la documentación visible; sus URL canónicas en la lista permitida del MCP apuntan a las versiones Markdown en inglés.

El servidor no acepta URL arbitrarias. Una ID o su URL canónica exacta devuelve el contenido público existente, no una búsqueda general de webs ni datos privados de cuentas.

Los MCP de productos autentican por separado

Memory, CRM y GEO son servidores de producto independientes. La conexión anónima de documentación no inicia sesión en ellos. Usa el catálogo MCP y los metadatos de cada servidor de producto.

En una conexión MCP normal de Memory, el cliente usa OAuth 2.1 Authorization Code con PKCE (S256). El scope documentado memory concede acceso completo a la cuenta de Memory autenticada; no hay scopes separados de lectura y escritura. Explica su alcance antes de que el usuario autorice la conexión.

Tus scripts REST pueden enviar la clave API del tenant como Authorization: Bearer, según el contrato de Memory. Una clave de licencia de la web no es una clave de tenant de Memory. Los tokens de producto, claves API y cookies del portal no pertenecen al MCP anónimo de documentación ni a la API pública de la web. Ante 401, sigue la cabecera WWW-Authenticate y el descubrimiento OAuth del propio servidor.

Descubrimiento y contratos relacionados

La card propia describe el servidor de documentación y su endpoint anónimo Streamable HTTP. Está separada de las cards de productos y usa el formato experimental MCP Server Cards. Consulta al servidor la lista actual de herramientas.

El índice legible por máquinas, las instrucciones públicas para agentes y el catálogo MCP enlazan los contratos reales. Usa la guía de API para peticiones a la web y la documentación independiente de Memory para acceder a tu propia memoria.