Nosotros y terceros seleccionados usamos cookies o tecnologías similares con fines técnicos y, con tu consentimiento, para analizar cómo se usa el sitio.

Puedes dar, negar o retirar libremente tu consentimiento en cualquier momento.

Ref

Servidor MCP de Ref

Busca en documentación pública y privada y lee páginas como Markdown usando el menor número posible de tokens.

Requiere clave de API (Requiere una clave de API del proveedor)Streamable HTTP

Conectar con Ref

Ref requiere una clave de API. Conéctate con su propia URL y tu clave:

https://api.ref.tools/mcp

Envía tu clave en la cabecera X-Ref-Api-Key. mcp.tc nunca ve ni guarda claves. Dónde conseguir una clave

Compartir este servidor

El enlace abre esta página, con la URL y los pasos de configuración.

mcp.tc/i/ref-tools

Descripción

Ref da a los agentes de programación acceso a la documentación de API, servicios y bibliotecas. Busca en documentación pública en la web y en GitHub, además de fuentes privadas como repositorios y PDF, y lee una URL como Markdown. Usa el historial de búsquedas de la sesión MCP para omitir resultados repetidos y devolver solo la parte más relevante de una página, unos 5k tokens.

Hay disponible un endpoint Streamable HTTP alojado en https://api.ref.tools/mcp, que acepta una clave de API en la cabecera X-Ref-Api-Key o en el parámetro de consulta apiKey. Un paquete local stdio, ref-tools-mcp, se ejecuta con npx y lee REF_API_KEY. El código fuente tiene licencia MIT.

Qué puedes hacer

  • Buscar documentación pública en la web y en GitHub
  • Buscar en repositorios privados y PDF
  • Leer cualquier URL convertida a Markdown
  • Omitir resultados repetidos entre búsquedas similares de una sesión
  • Devolver la parte más relevante de una página larga
  • Exponer los nombres de herramientas search y fetch para deep research de OpenAI

Herramientas

Ref solo muestra sus herramientas a clientes con clave, así que no podemos listarlas aquí.

Prompts de ejemplo

  • Encuentra el endpoint de la API REST de Figma para publicar un comentario.

  • Busca en la documentación cómo el nodo Merge de n8n gestiona varias entradas.

  • Lee esta URL de documentación y resume la sección de autenticación.

  • Consulta en su documentación el uso correcto de las opciones de configuración de esta biblioteca.

Configuración

Todos los clientes se conectan a api.ref.tools. Elige el tuyo; la página recuerda tu elección.

Claude Code

  1. Ejecútalo en un terminal, en la carpeta de tu proyecto:
claude mcp add --transport http ref-tools https://api.ref.tools/mcp --header "X-Ref-Api-Key: <YOUR_API_KEY>"
  1. Sustituye el marcador por tu clave antes de ejecutarlo, y después compruébalo con /mcp dentro de Claude Code.

Añade --scope user para que esté disponible en todos los proyectos, no solo en este.

Claude Desktop

  1. Usa el puente mcp-remote, que guarda la clave en este equipo (un conector añadido en claude.ai con la clave en Request headers también aparece aquí). Abre Settings → Developer → Edit Config y añade:
claude_desktop_config.json
{
  "mcpServers": {
    "ref-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.ref.tools/mcp",
        "--header",
        "X-Ref-Api-Key: <YOUR_API_KEY>"
      ]
    }
  }
}
  1. Sustituye el marcador por tu clave y reinicia Claude Desktop.

El puente necesita Node.js en tu equipo.

claude.ai

  1. Abre el formulario de conectores en claude.ai. Este botón rellena el nombre y la URL por ti:
  1. Comprueba que la URL es https://api.ref.tools/mcp. En Request headers, añade X-Ref-Api-Key: <YOUR_API_KEY> con tu clave de Ref y luego haz clic en Add.
  2. Actívalo en un chat desde el menú de herramientas.

Los planes gratuitos permiten un conector personalizado. En los planes Team y Enterprise lo añade un propietario en Organization settings → Connectors.

Cursor

O añádelo a mano en ~/.cursor/mcp.json (todos los proyectos) o en .cursor/mcp.json (este proyecto):

mcp.json
{
  "mcpServers": {
    "ref-tools": {
      "url": "https://api.ref.tools/mcp",
      "headers": {
        "X-Ref-Api-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

VS Code

Añádelo a .vscode/mcp.json. VS Code pide la clave la primera vez y la guarda de forma segura:

.vscode/mcp.json
{
  "servers": {
    "ref-tools": {
      "type": "http",
      "url": "https://api.ref.tools/mcp",
      "headers": {
        "X-Ref-Api-Key": "${input:x-ref-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "x-ref-api-key",
      "description": "X-Ref-Api-Key",
      "password": true
    }
  ]
}

Devin Desktop

  1. Añádelo a ~/.config/devin/mcp_config.json (macOS y Linux) o a %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "ref-tools": {
      "serverUrl": "https://api.ref.tools/mcp",
      "headers": {
        "X-Ref-Api-Key": "<YOUR_API_KEY>"
      }
    }
  }
}
  1. Actualiza la lista de servidores MCP en Cascade.

Devin Desktop es el nuevo nombre de Windsurf. Para los servidores remotos lee serverUrl (o url).

Codex

codex mcp add ref-tools --url https://api.ref.tools/mcp

codex mcp add no puede definir la cabecera X-Ref-Api-Key, así que este paso es obligatorio: pon esta entrada en ~/.codex/config.toml en lugar de ejecutar el comando, o añade su línea env_http_headers a la entrada que creó el comando:

config.toml
[mcp_servers.ref-tools]
url = "https://api.ref.tools/mcp"
env_http_headers = { "X-Ref-Api-Key" = "X_REF_API_KEY" }

Codex lee los valores de las cabeceras de las variables de entorno indicadas en env_http_headers.

Gemini CLI

gemini mcp add --transport http --header "X-Ref-Api-Key: <YOUR_API_KEY>" ref-tools https://api.ref.tools/mcp

Así lo añades al proyecto actual. Añade -s user para usarlo en todas partes.

Cualquier cliente

La mayoría de los clientes aceptan esta forma. Algunos llaman de otra manera al campo de la URL: serverUrl en Devin Desktop, httpUrl en el archivo de ajustes de Gemini CLI.

{
  "mcpServers": {
    "ref-tools": {
      "type": "http",
      "url": "https://api.ref.tools/mcp",
      "headers": {
        "X-Ref-Api-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

Zed pone los servidores bajo context_servers en sus ajustes. Cline necesita "type": "streamableHttp"; si no, supone SSE.

¿Tu cliente solo inicia servidores locales? Conéctalo con npx -y mcp-remote https://api.ref.tools/mcp.

Insertar

Muestra Ref en un README o en tu web. Cada inserción enlaza a esta página, usa la URL propia del servidor y no instala cookies. Cómo funcionan las inserciones

La tarjeta, el iframe y el JSON están en inglés. Añade ?lang=it, fr, de o es a su dirección para otro idioma.

Insignia para README

Vista previa de la insignia, claraVista previa de la insignia, oscura
Markdown
[![Ref on mcp.tc](https://mcp.tc/i/ref-tools/badge.svg)](https://mcp.tc/i/ref-tools)
HTML
<a href="https://mcp.tc/i/ref-tools"><img src="https://mcp.tc/i/ref-tools/badge.svg" alt="Ref on mcp.tc" height="20"></a>

Sigue el modo claro u oscuro de quien lee. Añade ?theme=light o ?theme=dark para fijarlo, o ?style=compact para mostrar el símbolo sin la palabra.

Tarjeta para web

HTML
<script src="https://mcp.tc/w/ref-tools.js" async></script>

La tarjeta aparece donde esté la etiqueta. Añade data-theme="dark" o data-size="compact" a la etiqueta para cambiarla. El archivo contiene todo lo que necesita, así que no hace otras solicitudes ni instala cookies.

iframe

HTML
<iframe src="https://mcp.tc/embed/ref-tools" title="Ref on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Úsalo en páginas que no permiten scripts. Añade ?theme=light o ?theme=dark a la dirección para fijar los colores.

JSON

La ficha como datos para tus propias páginas y herramientas: nombre, descripción corta, la URL propia del servidor, herramientas y los enlaces «Add to». Cualquier web puede leerla (CORS abierto).

https://mcp.tc/i/ref-tools.json

Qué significa cada campo

Prompt para la IA

Pégalo en un asistente de programación con IA, como Claude Code o Cursor, y añadirá la tarjeta de Ref a tu web.

Markdown
Añade a mi web la tarjeta de mcp.tc de Ref, un servidor MCP. Es un solo script estático: sin paso de build, sin paquetes que instalar, sin cookies.

Pon esta etiqueta donde deba aparecer la tarjeta. La tarjeta se muestra justo antes de ella:

```html
<script src="https://mcp.tc/w/ref-tools.js" async></script>
```

Para mostrarla en otro sitio, pon allí este marcador y carga el mismo script una sola vez, por ejemplo antes de `</body>`. Deja el enlace dentro: lo ven los visitantes sin JavaScript.

```html
<div data-mcptc="ref-tools"><a href="https://mcp.tc/i/ref-tools">Ref on mcp.tc</a></div>
```

Opciones:
- `data-theme="light"` o `"dark"` en la etiqueta o el marcador fija los colores. Sin él, la tarjeta sigue el modo claro u oscuro del visitante.
- `data-size="compact"` da una tarjeta más pequeña, sin el eslogan.
- La variable CSS `--mcptc-max-width` en el marcador o en un elemento padre fija el ancho (por defecto `520px`).
- `?lang=` en la URL del script fija el idioma de la tarjeta: `en`, `it`, `fr`, `de` o `es`.

Si el sitio tiene una Content Security Policy, permite `script-src https://mcp.tc` e `img-src data:` (el icono va incrustado).

Para un README u otra documentación en Markdown, usa la insignia:

```markdown
[![Ref on mcp.tc](https://mcp.tc/i/ref-tools/badge.svg)](https://mcp.tc/i/ref-tools)
```

Referencia: https://mcp.tc/es/embed

Historial de cambios

Sus herramientas requieren iniciar sesión, así que no podemos leerlas. Aquí aparecen las ediciones de su responsable.

Sigue Ref y te enviaremos un correo cuando algo cambie.

Todavía no hay nada registrado. Aquí aparecerán las ediciones del responsable del servidor.

Preguntas frecuentes

¿Puedo pegar mcp.tc/i/ref-tools en mi cliente MCP?

No. Los enlaces de mcp.tc son páginas, no direcciones de servidores. Conéctate con https://api.ref.tools/mcp, para que tu cliente hable directamente con Ref. Tu clave también va ahí, nunca a mcp.tc. El enlace rápido sirve para compartir: abre esta página, con los pasos de configuración para cada cliente.

¿Ref necesita una clave de API o iniciar sesión?

Sí. Ref necesita una clave de API, enviada en la cabecera X-Ref-Api-Key. Consíguela en Ref y guárdala en la configuración de tu cliente, nunca en un archivo compartido.

¿Ref es un servidor remoto o local?

Remoto. Lo aloja Ref en https://api.ref.tools/mcp, y usa Streamable HTTP. No hay nada que instalar.

¿Qué puede hacer Ref?

Puedes buscar documentación pública en la web y en GitHub, buscar en repositorios privados y PDF y leer cualquier URL convertida a Markdown.

¿Qué clientes pueden usarlo?

Cualquier cliente compatible con servidores MCP remotos que pueda enviar tu clave: Claude Code, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed y otros. En claude.ai y Claude Desktop, añade la clave como cabecera de la solicitud al crear el conector personalizado. ChatGPT no puede enviar una clave, así que no puede usarlo.

¿mcp.tc sigue los cambios de Ref?

En parte. Las herramientas de Ref requieren iniciar sesión, así que su pestaña Historial solo muestra las ediciones de su responsable. Sigue la ficha para recibir un correo cuando cambie.

¿Quién escribió esta página?

El robot de mcp.tc leyó los metadatos propios de Ref (su handshake MCP, su lista de herramientas y sus páginas públicas), y un modelo de IA redactó el texto a partir de ellos. Una persona revisa todo lo que las comprobaciones no pueden confirmar. Aun así, el texto puede contener errores, así que si encuentras uno, usa Reportar esta ficha en esta página. Esta traducción la hizo un modelo de IA a partir del texto en inglés.

mcp.tc no tiene relación con Ref. Esta página se creó a partir de los metadatos públicos de Ref, comprobados por última vez el 17 nov 2026, y un modelo de IA escribió la descripción, así que puede contener errores. Los nombres y marcas pertenecen a sus titulares. ¿Algo no cuadra? Reportar esta ficha. La traducción la hizo un modelo de IA a partir del texto en inglés.