@limelink/mcp

한국어 · Documentación · Referencia de capacidades

Un servidor de Model Context Protocol (MCP) para la gestión de enlaces dinámicos de LimeLink. Crea, consulta y gestiona enlaces dinámicos directamente desde Claude Code, Claude Desktop o cualquier cliente compatible con MCP.

¡No se requiere clave de API para empezar! La documentación y las guías de configuración del SDK funcionan sin ninguna configuración. Solo conéctate y empieza a explorar las funciones de LimeLink con tu asistente de IA.

Características

• Recursos de documentación — Accede a la documentación de LimeLink (15 páginas + índice) directamente desde tu asistente de IA — no se necesita clave de API

• 5 herramientas — Descubre perfiles y proyectos, crea enlaces dinámicos y consulta enlaces (las herramientas de API requieren un perfil configurado)

• Caché en memoria — Caché TTL de 1 hora para las descargas de documentación

Entorno de ejecución

• Node.js 18 o superior

• Solo transporte stdio; no se admite transporte MCP/HTTP remoto

• Paquete npm: @limelink/mcp; ejecutable global: limelink-mcp

• stdout está reservado para el protocolo MCP; los diagnósticos y los registros del wrapper deben usar stderr

Consulta instalación y configuración y comportamiento de red para conocer el contrato operativo completo.

¿Qué funciona sin una clave de API?

Related MCP server: lynxprompt-mcp

Inicio rápido

Sin clave de API (Documentación y guías)

No se necesita clave de API. Conéctate y empieza a explorar la documentación y las guías de configuración de LimeLink de inmediato:

{
  "mcpServers": {
    "limelink": {
      "command": "npx",
      "args": ["-y", "@limelink/mcp"]
    }
  }
}

Prueba a preguntarle a tu asistente de IA:

• "Lee la documentación de inicio de LimeLink"

• "¿Cómo configuro el deep linking para iOS?"

• "Muéstrame la guía de integración del SDK de LimeLink"

Con perfiles de organización (funciones completas)

Crea el archivo de perfil versión 1 que se muestra a continuación y pasa su ruta absoluta:

{
  "mcpServers": {
    "limelink": {
      "command": "npx",
      "args": ["-y", "@limelink/mcp"],
      "env": {
        "LIMELINK_PROFILES_FILE": "/absolute/path/to/limelink-profiles.json"
      }
    }
  }
}

Uso con instalación global

npm install -g @limelink/mcp

{
  "mcpServers": {
    "limelink": {
      "command": "limelink-mcp",
      "env": {
        "LIMELINK_PROFILES_FILE": "/absolute/path/to/limelink-profiles.json"
      }
    }
  }
}

Configuración

Claude Code

La forma más sencilla de añadir el servidor MCP es usar el comando claude mcp add:

# Without API key (docs & guides only)
claude mcp add --scope user --transport stdio limelink -- npx -y @limelink/mcp

# With API key (full features)
claude mcp add --scope user --transport stdio limelink \
  --env LIMELINK_PROFILES_FILE=/absolute/path/to/limelink-profiles.json \
  -- npx -y @limelink/mcp

Opciones de ámbito:

• --scope user — Disponible en todos los proyectos

• --scope project — Se guarda en .mcp.json (se puede compartir con el equipo mediante Git)

Claude Desktop y otros clientes MCP

Añade la configuración JSON al archivo de configuración de tu cliente:

Archivo de perfil

{"version":1,"defaultProfile":"work","profiles":{"work":{"apiKey":"your_api_key","organizationLabel":"Work","projects":{"marketing":"11111111-1111-4111-8111-111111111111"}}}}

Variables de entorno

LIMELINK_API_KEY y LIMELINK_PROJECT_ID se ignoran. Cuando no hay un perfil de credenciales configurado, las herramientas de API dirigen al agente a Organizaciones para emitir una clave de API de organización y configurar el archivo de perfil. Las herramientas de proyectos aceptan directamente un UUID de proyecto. El mapa projects opcional de un perfil es una conveniencia recomendada para proyectos de uso frecuente, no un requisito; añade alias después del descubrimiento con list-projects si resulta útil. Los perfiles se inicializan de forma diferida mediante la introspección de credenciales en su primera llamada a la API. Los cambios en el archivo de perfil, incluida la adición de alias, requieren reiniciar el servidor MCP.

Puedes obtener tu clave de API desde el panel de LimeLink. Sin una clave de API, los recursos de documentación y las guías de configuración del SDK están totalmente disponibles.

Herramientas

list-profiles

Enumera los alias configurados, las etiquetas de organización, el estado predeterminado y el estado de inicialización actual sin contactar con la API. Los perfiles ya inicializados incluyen ámbitos. Los valores de las claves de API permanecen secretos y nunca se devuelven. Los identificadores de organización, proyecto, dominio personalizado y credenciales, así como los prefijos de clave, son identificadores no secretos y pueden aparecer en las respuestas de las herramientas de API cuando sea útil.

list-projects

Enumera los proyectos de la organización descubierta a partir de la credencial del perfil seleccionado. Acepta un profile opcional; la credencial requiere projects:read.

list-custom-domains

Enumera los dominios personalizados del project requerido (alias o UUID). Acepta un profile opcional; la credencial requiere domains:read.

create-link

Crea un Core Link V2 con deep linking específico de la plataforma, selección de dominio personalizado, vistas previas sociales y seguimiento UTM.

Parámetros:

Ejemplo de uso en Claude:

"Crea un enlace dinámico para https://example.com/product/123 con el sufijo 'product-123' y habilita analytics"

get-link-by-suffix

Consulta un enlace dinámico por su sufijo.

get-link-by-url

Resuelve un enlace mediante la API V2 usando su URL completa. El backend determina si la URL pertenece a un espacio de nombres gratuito predeterminado, a un hostname de proyecto o a un dominio personalizado activo. No se requiere selector de proyecto ni análisis local de sufijo.

La URL debe ser una URL HTTPS absoluta con exactamente un segmento de ruta /{suffix} y sin query, fragmento, puerto explícito ni credenciales.

Recursos

limelink://docs/index

Devuelve el índice completo de documentación de LimeLink (llms.txt).

limelink://docs/{slug}

Devuelve páginas de documentación individuales. Slugs disponibles:

introduction, getting-started, project, application, dynamic-link, create-link, link-detail, link-management, appearance, sdk-integration, ios-sdk, android-sdk, api-integration, advanced, llm-agent

Ejemplo de uso en Claude:

"Lee la documentación de integración de API de LimeLink"

Claude accederá a limelink://docs/api-integration

Desarrollo

Requisitos previos

• Node.js >= 18

• pnpm

Configuración

git clone https://github.com/hellovelop/limelink-mcp-server.git
cd limelink-mcp-server
pnpm install
pnpm run build

Ejecutar localmente

LIMELINK_PROFILES_FILE=/absolute/path/to/limelink-profiles.json node dist/index.js

Pruebas

pnpm test          # Unit tests
pnpm test:e2e      # E2E tests (MCP stdio communication)
pnpm test:watch    # Unit tests in watch mode
pnpm test:coverage # Coverage report

Estructura del proyecto

src/
├── index.ts              # Entry point
├── lib/
│   ├── config.ts         # Environment variable loading
│   ├── cache.ts          # In-memory TTL cache
│   ├── api-client.ts     # LimeLink API HTTP client
│   └── doc-fetcher.ts    # Documentation fetcher with caching
├── tools/
│   ├── create-link.ts    # create-link tool
│   ├── get-link-by-suffix.ts
│   └── get-link-by-url.ts
└── resources/
    └── documentation.ts  # Documentation resources

Licencia

MIT