Guía de conector3 minutos de lectura9 herramientas MCP7 idiomas

Conectar Holded MCP con Gemini CLI

Holded: la suite empresarial española para pymes: contactos, documentos de venta y compra, productos, almacenes, cuentas de tesorería y embudos de CRM. REST API v1, autenticación con API key.

HCPor el equipo de HelpCodeActualizado 3 min de lectura Código abierto en GitHub

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

Holded

Holded

Holded — the Spanish SMB business suite: contacts, sales and purchase documents, products, warehouses, treasury accounts and CRM funnels. REST API v1, API-key auth.

herramientas

9

Región

ES

Categoría

Contabilidad

Autenticación

API Key

Env vars requeridas

HOLDED_API_KEY
Instalar con un clic en Cloud

7 días de prueba gratis · Sin tarjeta de crédito

  • Prueba gratis de 7 días
    Sin tarjeta de crédito
  • RGPD y SOC 2 ready
    Datos en la UE, registros de auditoría
  • Código abierto en GitHub
    Open source · AGPL-3.0
  • Funciona con ChatGPT, Claude, Gemini
    Cualquier cliente compatible con MCP

Resumen

Holded: la suite empresarial española para pymes: contactos, documentos de venta y compra, productos, almacenes, cuentas de tesorería y embudos de CRM. REST API v1, autenticación con API key.

Configuración guiada

Conecta Holded a Gemini en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta Holded con la configuración guiada y añade tu URL MCP a Gemini. Sin código y sin servidores que mantener.

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

Prueba a pedir

Prompts de ejemplo para Holded

Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.

Holded · live vía MCP
Compartir
Opus 4.7

Claude es IA y puede equivocarse. Verifica siempre las respuestas.

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Holded, pega tus credenciales, genera una MCP API key — listo. Sin Docker, sin git clone, sin servidor local.

Holded + Gemini

Holded: la suite empresarial española para pymes: contactos, documentos de venta y compra, productos, almacenes, cuentas de tesorería y embudos de CRM. REST API v1, autenticación con API key.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

HOLDED_API_KEY

Paso 1 — Obtener credenciales

Getting a key

  1. Sign in to Holded and open Configuración → Desarrolladores → API key (Settings → Developers).
  2. Generate a key and put it in HOLDED_API_KEY. The key belongs to the account, not to a user, and carries full access to every module you have subscribed to — treat it as a password.

The key travels in a key header. Not Authorization, not a query parameter. Holded's own documentation calls it simply key.

This adapter uses Holded's v1 API (/api/invoicing/v1, /api/crm/v1), which is still served. Holded's current developer site documents a newer v2 API with Authorization: Bearer and different paths; this adapter does not use it.

…(continued in the in-app connector instructions)

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee servidores MCP desde ~/.gemini/settings.json (o %APPDATA%\gemini\settings.json en Windows). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Obtén tu MCP API key desde AnythingMCP → MCP Servers → tu servidor → API keys.
  2. Guarda el archivo y reinicia gemini.
  3. Ejecuta /mcp en la Gemini CLI — Holded debería aparecer como disponible.
  4. Vertex AI Studio: pasa https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID al array tools de tu petición con el mismo header X-API-Key.

Herramientas disponibles

ToolWhat it does
holded_list_contactsList contacts — customers, suppliers, leads — with their name, NIF/CIF, e-mail, address and the type flags that say which role they hold
holded_get_contactRead one contact in full: tax data, billing address, payment terms, default VAT rate and the notes recorded against them
holded_list_documentsList documents of one type — invoices, estimates, credit notes, purchase orders — with their number, date, contact, total and payment status
holded_get_documentRead one document in full: every line with its quantity, price, discount and VAT, the totals, and the payments applied against it
holded_list_productsList products and services with their SKU, name, price, cost, VAT rate and stock level
holded_list_warehousesList warehouses with their name and location, so a stock question can name the right one
holded_list_treasury_accountsList the treasury accounts (bank and cash) with their name, IBAN and current balance — the cash-position answer
holded_list_funnelsList the CRM funnels with their stages, so a pipeline question knows which stages exist before asking about leads in them
holded_list_leadsList CRM leads with their name, contact, value, funnel stage and expected close date — the sales-pipeline view

FAQ

¿Gemini 1.5 Pro o 2.x soportan MCP? Sí — Gemini CLI ≥ 0.4 y la API de tools de Vertex AI aceptan conectores MCP httpUrl con header personalizzati.

Siguientes pasos

¿Te ha sido útil esta guía?

Conecta Holded a Gemini en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta Holded con la configuración guiada y añade tu URL MCP a Gemini. Sin código y sin servidores que mantener.

Guías relacionadas