---
author: OOMOL
author_url: https://oomol.com/es/about/
datePublished: 2026-11-11
title: "MCP vs API: diferencias, ejemplos y cuándo usar cada uno"
description: "Compara MCP y API con una misma consulta de cuenta de solo
  lectura: descubrimiento, credenciales, ejecución y errores."
lang: es
canonical_url: https://oomol.com/es/blog/mcp-vs-api/
markdown_url: https://oomol.com/es/blog/mcp-vs-api.md
---

Una API directa permite que tu código elija la operación y los parámetros. MCP da a un cliente de IA una interfaz común para descubrir e invocar herramientas. Un servidor MCP puede llamar a una API internamente, de modo que ambas opciones pueden convivir.

## Qué cambia en la interfaz

Con API/SDK, el código selecciona la operación y procesa la respuesta. Con MCP, el cliente descubre las herramientas del servidor y las invoca mediante el protocolo. Sigue siendo necesario el permiso del servicio. Consulta la [arquitectura oficial](https://modelcontextprotocol.io/docs/learn/architecture).

## Usar la misma tarea

Identifica la cuenta GitHub conectada a OOMOL por ambas vías. Conecta primero la cuenta correcta.

## Llamar desde el backend

Instala `@oomol-lab/connector`, crea una clave personal y guárdala como secreto de backend `OOMOL_API_KEY`. Ejecuta solo en un servidor de confianza:

```ts
import { Connector } from "@oomol-lab/connector";

const connector = new Connector({
  apiKey: process.env.OOMOL_API_KEY!,
  team: "<team-name>",
});
const result = await connector.execute("github.get_current_user", {});
console.log(result);
```

Sustituye `<team-name>` por el equipo OOMOL que contiene la conexión GitHub y selecciona ese mismo equipo en la configuración MCP siguiente.

Contrasta la identidad devuelta. La [guía Connector](/es/docs/connector-client/) explica cómo elegir entre varias conexiones. Las claves personales, de proyecto y de MCP tienen funciones distintas.

## Llamar mediante MCP

Abre la [configuración MCP](/es/install/mcp/), selecciona el ámbito personal o de equipo correcto y añádela a un cliente compatible.

> Usa OOMOL MCP para leer el usuario GitHub conectado. Si hay varias conexiones, pídeme elegir. Devuelve los campos de identidad reales sin modificar nada.

Comprueba que sea la misma cuenta. OOMOL ofrece herramientas de descubrimiento y ejecución; no todas las operaciones GitHub aparecen individualmente. Consulta la [guía MCP](/es/docs/agents/mcp/).

## Seguir una operación por ambas interfaces

El SDK llama a la API alojada de OOMOL, no directamente a GitHub. Una integración directa con GitHub debe gestionar sus propias credenciales y respuestas.

| Paso | SDK de OOMOL | Cliente MCP |
| --- | --- | --- |
| Descubrir | Inspecciona `connector.catalog.action("github.get_current_user")`. | Descubre herramientas y esquemas; busca la operación con las herramientas de OOMOL. |
| Entradas | Pasa el ID y `{}`; selecciona la cuenta por separado. | Envía argumentos según el esquema, incluida la cuenta cuando corresponda. |
| Autorizar | Clave personal, equipo y conexión GitHub. | Clave MCP, equipo y la misma conexión. OAuth no sustituye la clave OOMOL. |
| Ejecutar | Espera `connector.execute(...)`. | Llama a la herramienta; el host decide aprobaciones y coordinación. |
| Resultado | `execute` devuelve datos; `executeRaw` añade metadatos. | Comprueba el resultado de la herramienta antes del resumen del modelo. |

MCP unifica descubrimiento y llamadas, pero no exige que un modelo elija cada operación. Una API también puede exponerse como herramienta del modelo. Ambos caminos requieren mantener compatibilidad y gestionar cambios de la API subyacente.

## Distinguir los fallos

Separa autenticación fallida, equipo incorrecto, conexión ausente y respuesta vacía válida. Registra errores sin secretos. Para tareas mayores, iguala filtros, paginación y campos.

Con el SDK, captura `ConnectorError` e inspecciona `code`, `status` y los identificadores disponibles; consulta los reintentos en la [referencia SDK](/es/docs/connector-sdk/). Corrige credenciales o cuenta antes de repetir un fallo de autorización. En MCP, distingue errores de conexión y de herramienta. Si el descubrimiento funciona pero la consulta falla, revisa equipo y conexión GitHub. Conserva el error sin secretos y el identificador de la operación.

## Elegir por el flujo de trabajo

Usa API/SDK si el código controla horarios, entradas y reintentos; MCP si un cliente IA debe descubrir herramientas. Una API sencilla puede bastar sin plataforma adicional. La [referencia SDK](/es/docs/connector-sdk/) distingue cuentas propias/de equipo y de clientes. Puedes probar [OOMOL Chat](https://console.oomol.com/overview) o continuar con [GitHub](/es/integrations/github/) y [Search Console](/es/integrations/google_search_console/).
