The-Snip

Base de conocimiento del equipo para fragmentos de código, llamadas a API y documentación. Los agentes buscan y archivan elementos a través de MCP; los humanos revisan lo que se vuelve canónico.

Ver en the-snip.comPrueba este MCPPatrocinado

Documentación

Pruébalo ahora — sin registro

Pega esta configuración y tu agente puede buscar en un espacio de trabajo de demostración compartido de solo lectura de inmediato. Tiene límite de velocidad y sus escrituras siempre se rechazan en el servidor: regístrate para obtener tu propia base y consigue tus 5 escrituras de agente gratuitas.

// shared demo workspace — this key works

{
  "mcpServers": {
    "the-snip-demo": {
      "url": "https://the-snip.com/mcp",
      "headers": {
        "Authorization": "Bearer snip_kTHay3_E_PRcubQBouPQM8hnHoEKhWvXAJS6MCZwSPwqDX-hkmsU"
      }
    }
  }
}

Cómo funciona

Tu agente busca en la base durante la tarea (search_base) y obtiene las respuestas aprobadas del equipo.
Confía en lo que encuentra: solo los elementos aprobados por humanos son canónicos.
Cuando aprende algo nuevo, lo archiva (create_snippet / create_api / create_doc / create_webpage): cada escritura cae en revisión.
Un humano lo aprueba en la cola de revisión; la base sigue siendo confiable.

Entrega uno de estos archivos a cualquier agente de IA: el archivo combinado cubre MCP + REST; el archivo MCP es solo el contrato de esta página:

// the-snip-for-agents.md — paste into your CLAUDE.md

Descargar el archivo de instrucciones del agente

// the-snip-mcp-setup.md — MCP-only setup, for your agent's context

Descargar el archivo de configuración de MCP

Cómo conectarse

Crea un espacio de trabajo en the-snip.com — gratis, sin tarjeta.
Genera una clave de API en Configuración → Claves de API.
Añade el servidor a tu cliente con una de las configuraciones siguientes.

// Claude Code — one command

claude mcp add --transport http the-snip https://the-snip.com/mcp \
  --header "Authorization: Bearer snip_YOUR_WORKSPACE_KEY"

{
  "mcpServers": {
    "the-snip": {
      "url": "https://the-snip.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THESNIP_API_KEY}"
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "the-snip": {
        "url": "https://the-snip.com/mcp",
        "transport": "streamable-http",
        "headers": {
          "Authorization": "Bearer snip_YOUR_WORKSPACE_KEY"
        }
      }
    }
  }
}

// Hermes (Nous Research) — ~/.hermes/config.yaml

mcp_servers:
  the-snip:
    url: "https://the-snip.com/mcp"
    headers:
      Authorization: "Bearer snip_YOUR_WORKSPACE_KEY"

// VS Code (Copilot agent mode) —.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "thesnip-api-key",
      "description": "The-Snip workspace API key (snip_...)",
      "password": true
    }
  ],
  "servers": {
    "the-snip": {
      "type": "http",
      "url": "https://the-snip.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:thesnip-api-key}"
      }
    }
  }
}

// OpenAI Codex CLI — ~/.codex/config.toml

[mcp_servers.the-snip]
url = "https://the-snip.com/mcp"
bearer_token_env_var = "THESNIP_API_KEY"

{
  "mcpServers": {
    "the-snip": {
      "httpUrl": "https://the-snip.com/mcp",
      "headers": {
        "Authorization": "Bearer $THESNIP_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "the-snip": {
      "type": "streamableHttp",
      "url": "https://the-snip.com/mcp",
      "headers": {
        "Authorization": "Bearer snip_YOUR_WORKSPACE_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "the-snip": {
      "url": "https://the-snip.com/mcp",
      "headers": { "Authorization": "Bearer snip_YOUR_KEY" }
    }
  }
}

Funciona con

Cualquier cliente que hable Streamable HTTP y pueda enviar un encabezado Authorization se conecta hoy. Sintaxis de configuración por herramienta, verificada contra la documentación oficial de cada proyecto (julio de 2026):

Herramienta	Archivo de configuración	Autenticación de encabezado	Cuidado con
Claude Code	.mcp.json / claude mcp add	Sí	Las entradas de .mcp.json necesitan "type": "http" — una url sin tipo es un error de configuración
Cursor	.cursor/mcp.json	Sí	La interpolación ${env:VAR} funciona en los encabezados — mantén la clave fuera del archivo
OpenClaw	~/.openclaw/openclaw.json	Sí	establece "transport": "streamable-http"; la interpolación de entorno no está documentada — pega la clave
Hermes (Nous)	~/.hermes/config.yaml	Sí	allowed_tools puede exponer solo search_base para agentes de solo lectura
VS Code Copilot	.vscode/mcp.json	Sí	la clave de nivel superior es "servers", no "mcpServers"
OpenAI Codex CLI	~/.codex/config.toml	Sí	bearer_token_env_var envía el valor de entorno como encabezado Bearer
Gemini CLI	~/.gemini/settings.json	Sí	el campo es "httpUrl" — "url" significa SSE en Gemini CLI
Cline	Panel de Cline / ~/.cline/mcp.json	Sí	"type": "streamableHttp" debe ser explícito — omitirlo cae en SSE heredado
Windsurf	~/.codeium/windsurf/mcp_config.json	Sí	el campo de URL es "serverUrl", no "url"
Continue	config.yaml	Sí	los encabezados van bajo requestOptions.headers, no una clave headers simple
Zed	settings.json	Sí	los servidores viven bajo "context_servers"
Goose (Block)	~/.config/goose/config.yaml	Sí	el tipo es "streamable_http" con un campo "uri"

Los conectores personalizados de ChatGPT y claude.ai también funcionan ahora — mediante OAuth. Añade un conector personalizado apuntando a https://the-snip.com/mcp y tu navegador ejecutará un inicio de sesión OAuth único: inicia sesión en The-Snip, elige un espacio de trabajo y haz clic en Permitir — sin necesidad de pegar una clave. El conector luego lee y propone elementos (en revisión) a través de MCP, limitados al espacio de trabajo que elegiste. Revócalo en cualquier momento en Configuración → Claves de API → Aplicaciones conectadas.

Dos notas de configuración para conectores OAuth. ChatGPT requiere el modo Desarrollador (Configuración → Conectores → Avanzado) y muestra una advertencia de “no verificado” durante la conexión — eso es esperado para cualquier conector personalizado. Los espacios de trabajo gratuitos también se conectan — las lecturas son gratuitas, con 5 escrituras de agente gratuitas (sujetas a revisión) antes de necesitar Pro & Team. La ruta estática de encabezado Authorization: Bearer snip_… anterior no cambia y sigue siendo la opción más simple para Claude Code, Codex y mcp-remote.

Los clientes solo-stdio pueden conectarse con mcp-remote, configurado como servidor stdio:

// stdio-only clients — mcp-remote bridge

npx -y mcp-remote https://the-snip.com/mcp --header "Authorization: Bearer snip_YOUR_WORKSPACE_KEY"

Nueve herramientas

Herramienta	Qué hace	Comportamiento
search_base	Busca en la base revisada del equipo de fragmentos de código, llamadas API guardadas y documentos Markdown. SIEMPRE busca antes de crear: los casi duplicados deterioran una base compartida. Búsqueda de texto completo, no semántica: 2-4 palabras clave funcionan mejor; si los resultados están vacíos, reintenta con sinónimos. Una consulta vacía devuelve los elementos más recientes. Devuelve elementos completos; toma los ids de aquí para get_item y update_item. Gratis en todos los planes.	solo lectura · gratis
get_item	Obtiene un elemento completo por id. Toma los ids de los resultados de search_base — nunca los adivines (un id fuera de tu espacio de trabajo devuelve 404). Gratis en todos los planes.	solo lectura · gratis
list_collections	Lista las colecciones del espacio de trabajo (id y nombre). Verifica antes de archivar: pasa un collectionId real a create_* o update_item para que los elementos caigan donde el equipo espera — nunca adivines los ids de colección. Gratis en todos los planes.	solo lectura · gratis
create_snippet	Archiva código reutilizable que vale la pena conservar: un hook, un helper, una corrección que el equipo volverá a encontrar. Busca primero para evitar duplicados. Incluye description (qué y cuándo) y sampleOutput (cómo se ve una salida correcta — los futuros agentes dependen de ello). Cae en revisión: un humano aprueba antes de que sea canónico; "en revisión" es esperado, no lo reenvíes. Plan gratuito: 5 escrituras de agente de por vida (sujetas a revisión); ilimitado en Pro & Team.	cae en revisión (201) · 5 gratis, luego de pago
create_api	Archiva una solicitud API que funciona: el método, la URL, los encabezados y el cuerpo que realmente funcionaron. Busca primero para evitar duplicados. Usa sampleResponse para mostrar cómo se ve una buena respuesta. Cae en revisión para aprobación humana; no lo reenvíes mientras esté pendiente. Plan gratuito: 5 escrituras de agente de por vida (sujetas a revisión); ilimitado en Pro & Team.	cae en revisión (201) · 5 gratis, luego de pago
create_doc	Archiva conocimiento en prosa: runbooks, guías, notas de arquitectura, gotchas. El cuerpo es Markdown; [[wikilinks]] resuelven a otros documentos en el espacio de trabajo. Busca primero para evitar duplicados. Cae en revisión para aprobación humana. Plan gratuito: 5 escrituras de agente de por vida (sujetas a revisión); ilimitado en Pro & Team.	cae en revisión (201) · 5 gratis, luego de pago
create_webpage	Archiva una página web raspada que vale la pena conservar: páginas de documentación, changelogs, publicaciones de blog que el equipo necesitará de nuevo. sourceUrl es la URL canónica http(s) de la página; body es el contenido de la página convertido a Markdown. Busca primero para evitar duplicados — ¿re-raspar la misma página? Usa update_item en el elemento existente en su lugar. Incluye description (qué cubre la página y por qué se guardó). Cae en revisión: un humano aprueba antes de que sea canónico; no lo reenvíes mientras esté pendiente. Plan gratuito: 5 escrituras de agente de por vida (sujetas a revisión); ilimitado en Pro & Team.	cae en revisión (201) · 5 gratis, luego de pago
update_item	Corrige o extiende un elemento existente cuando un resultado de búsqueda está desactualizado o incompleto. Parchea por id desde search_base — nunca adivines ids (404 si no es visible). Acepta cualquier campo de create, todos opcionales; la actualización vuelve a poner el elemento en revisión. También es cómo mueves un elemento a una colección: pasa collectionId de list_collections. Plan gratuito: 5 escrituras de agente de por vida (sujetas a revisión); ilimitado en Pro & Team.	vuelve a revisión · 5 gratis, luego de pago
create_collection	Crea una colección para organizar elementos. Verifica list_collections primero — no crees casi duplicados de colecciones existentes. Devuelve la nueva colección incluyendo su id, lista para usar como collectionId. Plan gratuito: 5 escrituras de agente de por vida (sujetas a revisión); ilimitado en Pro & Team.	201 — sin revisión (metadatos organizativos) · 5 gratis, luego de pago

Los agentes proponen, los humanos aprueban

Cada escritura de agente — crear o actualizar — cae con estado "en revisión", y actualizar un elemento aprobado lo vuelve a poner en revisión. Los agentes estructuralmente no pueden establecer el estado: los esquemas de entrada rechazan campos desconocidos, por lo que un campo de estado "approved" de contrabando devuelve un 400, nunca un pase silencioso. Un humano aprueba los elementos en la cola de revisión, y solo los elementos aprobados son canónicos. Esa puerta es lo que hace que la base sea lo suficientemente confiable para servir como una memoria de equipo revisada para Claude Code — ver cómo los agentes leen y escriben en The-Snip.

Solución de problemas

// 401 — missing or invalid key

{"error":{"code":"unauthorized","message":"Missing API key"}}
{"error":{"code":"unauthorized","message":"Invalid API key"}}

Envía la clave como Authorization: Bearer snip_.... "Clave de API inválida" significa que la clave fue revocada o mal escrita: genera una nueva en Configuración → Claves de API. Un 401 de /mcp también lleva WWW-Authenticate: Bearer error="invalid_token".

// 403 — the workspace's 5 free agent writes are spent

{"error":{"code":"forbidden","message":"You've used your 5 free agent writes — they landed in your review queue. Unlimited agent writes are part of Pro & Team ($8/user): https://the-snip.com/upgrade"}}

Las lecturas (search_base, get_item, list_collections) son gratuitas en todos los planes, y cada espacio de trabajo gratuito recibe 5 escrituras de agente gratuitas (sujetas a revisión) — solo cuentan las escrituras que tienen éxito, y las ya archivadas están seguras en la cola de revisión. Las escrituras de agente ilimitadas son parte de Pro & Team: actualiza en the-snip.com/upgrade y la misma clave sigue escribiendo.

// 405 — GET probe on the endpoint

{"error":{"code":"method_not_allowed","message":"MCP is POST-only (Streamable HTTP). See https://the-snip.com/settings/api-keys for setup."}}

La respuesta lleva Allow: POST. El endpoint solo habla Streamable HTTP — los clientes en el transporte SSE más antiguo abren con un GET y ven esto; cambia la entrada del servidor al tipo Streamable HTTP mostrado arriba.

Preguntas, respondidas.

¿Cómo conecto Claude Code al servidor MCP de The-Snip?

Genera una clave de API de espacio de trabajo en Configuración → Claves de API, luego añade The-Snip al .mcp.json de tu proyecto con la URL del servidor https://the-snip.com/mcp y el encabezado Authorization: Bearer snip_... (en .mcp.json la entrada también necesita "type": "http"). Claude Code lo recoge en la próxima sesión y obtiene las nueve herramientas. Cursor, Windsurf, VS Code Copilot y cualquier cliente MCP de Streamable-HTTP se conectan de la misma manera: consulta la tabla de configuración por herramienta anterior.

¿Qué herramientas expone el servidor MCP?

Nueve. Lecturas (gratis en todos los planes): search_base, get_item, list_collections. Escrituras: create_snippet, create_api, create_doc, create_webpage, update_item, create_collection. Cada escritura cae en revisión — los agentes no pueden establecer el estado, por lo que un campo de estado de contrabando devuelve 400.

¿El servidor MCP es gratuito?

Las lecturas son gratuitas en todos los planes — cualquier agente puede buscar en la base en el plan gratuito. Cada espacio de trabajo gratuito también recibe 5 escrituras de agente gratuitas (sujetas a revisión, de por vida). Las escrituras de agente ilimitadas — crear y actualizar elementos, y crear colecciones — son parte de Pro & Team, $8/usuario/mes. Una vez gastadas las 5 escrituras gratuitas, una escritura desde un espacio de trabajo gratuito devuelve 403 apuntando a the-snip.com/upgrade, y los elementos ya archivados permanecen en la cola de revisión.

¿Puedo probar el servidor MCP sin registrarme?

Sí. Pega la configuración de demostración anterior y tu agente puede buscar en un espacio de trabajo de demostración compartido de solo lectura de inmediato. La clave de demostración tiene límite de velocidad y sus escrituras siempre se rechazan en el servidor: regístrate para obtener tu propia base y consigue tus 5 escrituras de agente gratuitas.

¿Los agentes necesitan sus propios asientos o inicios de sesión?

No. Los agentes se autentican con claves de API de espacio de trabajo, no con asientos — pagas por humano. Crea una clave separada por agente o por desarrollador para que cualquiera pueda ser revocada sin afectar al resto. Los conectores personalizados de ChatGPT y claude.ai también pueden conectarse mediante un inicio de sesión OAuth único en lugar de pegar una clave.