Saltar al contenido

DOCUMENTACIÓN

Clientes de OpenConnector: SDK, CLI, HTTP y MCP

Invoca un entorno de ejecución OpenConnector con el SDK de TypeScript, la CLI oo, HTTP o MCP, empezando con una acción pública de Hacker News.

Mantenido por OOMOL·

Código revisado el 2026-09-09. Estos ejemplos se contrastaron con la revisión del código enlazada. No implican una verificación de la API en vivo; tu versión desplegada puede ser diferente.

Cuándo usar OpenConnector

Usa OpenConnector cuando un agente de IA necesite llamar a servicios externos mediante cuentas autorizadas, o cuando quieras controlar las credenciales y las políticas de ejecución en tu propia infraestructura.

Cómo empezar

Elige un runtime autoalojado o alojado por OOMOL, conecta una cuenta, descubre una Action y revisa su esquema de entrada y sus permisos. Después, realiza una pequeña llamada de solo lectura y comprueba el resultado.

Alcance del runtime y de la API

Este dominio ofrece información y documentación del proyecto, no una API de conectores ni un servidor MCP en funcionamiento. Envía las llamadas al runtime elegido. Si lo autoalojas, consulta /openapi.json y /docs en ese runtime. Los productos SaaS que conectan las cuentas de sus propios usuarios deben seguir la guía independiente de integración de productos de OOMOL.

Guía de integración de productos ↗

Instalar el CLI oficial oo

Instala oo siguiendo la guía oficial y después usa oo connector para descubrir y llamar a Actions. Configura la URL del runtime, su token y las conexiones de cuentas para el despliegue elegido.

Instalar el CLI oficial oo ↗

SDK oficial de TypeScript

Instala @oomol-lab/connector desde npm. Usa el cliente OpenConnector para tu propio runtime; para cuentas personales alojadas o conexiones de usuarios finales de SaaS, sigue las guías de OOMOL SDK.

npm
npm install @oomol-lab/connector
npm: @oomol-lab/connector ↗

Referencia OpenAPI del runtime

Descarga la especificación generada a partir de una revisión fija del runtime. Antes de usarla, configura runtimeUrl con la dirección de tu despliegue. Los esquemas de Actions de cada proveedor se obtienen del catálogo de ese runtime. Este sitio no ejecuta llamadas a la API.

Referencia OpenAPI del runtime →Código del entorno de ejecución· 72de05b ↗

TypeScript

Instala primero @oomol-lab/connector. Este ejemplo llama desde Node.js a una instancia local de OpenConnector en ejecución.

TypeScript
import { OpenConnector } from "@oomol-lab/connector";

const connector = new OpenConnector({
  baseUrl: "http://localhost:3000",
  runtimeToken: process.env.OOMOL_CONNECT_RUNTIME_TOKEN,
});

const stories = await connector.hackernews.get_top_stories({});
console.log(stories);

CLI

Instala la CLI oo y dirige sus comandos connector a tu entorno de ejecución local. Los despliegues con autenticación también requieren un token del entorno de ejecución.

CLI
oo connector login http://localhost:3000
oo connector search "Hacker News"
oo connector schema hackernews.get_top_stories
oo connector run hackernews --action get_top_stories --data '{}'

HTTP

Ejecuta esta acción de solo lectura y sin autenticación en un entorno de ejecución local. Añade tu token Bearer del entorno de ejecución si la autenticación está habilitada.

HTTP
curl -s -X POST \
  http://localhost:3000/v1/actions/hackernews.get_top_stories \
  -H 'content-type: application/json' \
  -d '{"input":{}}'

MCP

Usa este endpoint HTTP de MCP en un entorno de agentes compatible. Consulta la guía de la API del entorno de ejecución para la autenticación de clientes y las herramientas admitidas.

MCP
http://localhost:3000/mcp

Lee el resultado

Las respuestas HTTP del entorno usan success, message, data y meta. Inspecciona success y el esquema de salida de la acción, no solo el estado HTTP. Cuando los metadatos de ejecución incluyan executionId, úsalo para localizar el registro correspondiente con datos sensibles ocultos. El ejemplo siguiente ilustra la estructura de la respuesta; no es un resultado de la API en vivo.

Respuesta ilustrativa
{
  "success": true,
  "message": "OK",
  "data": {},
  "meta": {}
}

Si falla la llamada

  • Si falla la autenticación, comprueba el endpoint y el tipo de credencial: el acceso de administración protege /api; un token Bearer del entorno autoriza /v1 y /mcp. Una clave de API del proveedor no es un token del entorno de ejecución.
  • Si se deniega un permiso, comprueba los ámbitos requeridos por la acción, las reglas de acciones del entorno y las concesiones de conexión. Un token válido puede seguir sin tener permiso para usar la cuenta seleccionada.
  • Si faltan resultados o están vacíos, confirma la cuenta conectada y su acceso al recurso solicitado. Una autorización exitosa no concede acceso a todos los espacios de trabajo, canales o documentos.
  • Inspecciona el error y el registro de ejecución antes de reintentar. Si una acción modifica datos del proveedor, comprueba si ya terminó; no repitas la solicitud a ciegas.
Leer en Markdown