Conectar SHAB MCP con Gemini CLI

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → SHAB Swiss Official Gazette of Commerce, instálalo sin clave, genera una clave API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

SHAB Swiss Official Gazette of Commerce + Gemini

Boletín Oficial Suizo de Comercio (SHAB/FOSC/FUSC) y boletines cantonales en amtsblattportal.ch, sin clave API: busca entradas del registro comercial, quiebras, ejecuciones de deudas, convocatorias a acreedores y otros avisos legales por UID de la empresa, nombre, rúbrica, cantón y fecha, y lee una publicación completa o como PDF firmado.

Requisitos previos

Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:

(ninguna: datos públicos, sin clave API)

Paso 1 — Configura el conector

Datos públicos, sin clave: la configuración tarda menos de un minuto. El conector lee la API abierta del portal de boletines oficiales suizos (amtsblattportal.ch, gestionado por la Secretaría de Estado de Asuntos Económicos SECO): el Boletín Oficial Suizo de Comercio (SHAB en alemán, FOSC en francés, FUSC en italiano, SOGC en inglés) y los boletines oficiales cantonales que publican allí. Cada entrada del registro comercial en Suiza, quiebras, ejecuciones de deudas, procedimientos de composición, convocatorias a acreedores y otros avisos legales aparecen aquí. No se necesita cuenta, clave API ni inicio de sesión.

1. En la tienda de conectores, elige SHAB Swiss Official Gazette of Commerce e instálalo. No hay nada que pegar y no hay paso de Autorizar con Proveedor.
2. Verifícalo con shab_search_publications, un nombre de empresa en keyword y tenant configurado en shab: lista las publicaciones de esa empresa en el boletín federal.

La nube y el autoalojamiento funcionan de la misma manera: no hay nada que configurar en ninguno de los dos.

Dónde empezar: shab_search_publications sigue a una empresa por su UID (uids, por ejemplo CHE-123.456.789, el más preciso) o por nombre (keyword), o vigila un mercado con rubrics y sub_rubrics, cantons y un rango de fechas (date_start, date_end, YYYY-MM-DD): por ejemplo, cada nueva quiebra (sub-rúbrica KK02) en el cantón ZH esta semana. Configura tenant en shab para permanecer en el boletín federal, o en un código de boletín cantonal como kabzh. shab_get_publication con el meta.id de un resultado devuelve el texto completo y el contenido estructurado, y shab_get_publication_pdf el PDF firmado.

Rúbricas: entradas del registro comercial HR (HR01 nueva entrada, HR02 cambio, HR03 eliminación), quiebras KK (KK01 aviso previo, KK02 publicación y convocatoria a acreedores, KK03 suspensión por falta de activos, hasta KK08 subasta de bienes), ejecuciones de deudas SB, procedimientos de composición NA, convocatorias a acreedores después de liquidación LS, otras convocatorias a acreedores SR (fusiones, reducciones de capital), avisos a miembros de la empresa UP (UP04 invitación a la junta general) y más. Los boletines cantonales tienen sus propias rúbricas con un sufijo de cantón.

Lectura de los datos: una entrada del registro comercial lleva el número y la fecha del diario diario, el texto oficial, y la empresa con nombre, UID, sede, forma jurídica (por ejemplo 0106 AG/SA, 0107 GmbH/Sàrl, 0108 cooperativa, 0110 fundación), propósito, capital y las personas cuyos derechos de firma cambiaron; en un cambio, también se incluyen los valores anteriores. Los textos están en alemán, francés o italiano dependiendo del cantón; los títulos también están en inglés.

Solo lectura: cada herramienta solo lee avisos publicados, por lo que no hay nada que confirmar y ninguna herramienta se desactiva al instalar.

Límites: page comienza en 0 y size llega hasta 2,000, pero los elementos son grandes, por lo que la IA mantiene de 20 a 100. Solo se pueden acceder a los avisos publicados sin una cuenta. El operador no garantiza la integridad o precisión de los datos de la API: solo el PDF firmado de una publicación es legalmente vinculante.

No incluido: el índice central de nombres comerciales Zefix (búsqueda de empresas con datos del registro actual) es una API federal separada que necesita credenciales de la Oficina Federal de Justicia. Usa las publicaciones del registro comercial SHAB aquí en su lugar.

El conector no publica avisos y no cambia nada en el registro comercial.

Paso 2 — Instala el adaptador

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 — Agrega 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 los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de SHAB Swiss Official Gazette of Commerce.

Herramientas disponibles

Ejemplos de indicaciones

• "Muestra todas las publicaciones del SHAB para la empresa con UID CHE-123.456.789 en los últimos dos años."
• "Lista las nuevas quiebras (KK02) publicadas en el cantón de Zúrich esta semana."
• "¿Qué cambió en el registro comercial para nuestro proveedor en su última entrada HR02: junta, derechos de firma o capital?"
• "Encuentra invitaciones a la junta general (UP04) publicadas este mes en el boletín federal."
• "Descarga el PDF firmado de la última entrada del registro comercial para esta empresa."

Preguntas frecuentes

¿Puede buscar empresas como Zefix? No. Zefix es una API federal separada que necesita credenciales. Este conector encuentra empresas a través de sus publicaciones del SHAB, por UID o por nombre.

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Próximos pasos

• Página de inicio del conector
• Conectar a Claude