# Cómo conectar indumás a tu asistente de IA

Paso a paso para conectar el servidor MCP de indumás a Claude, Claude Code, ChatGPT, Codex, Cursor o VS Code. Lleva un par de minutos y usa tu cuenta de indumás, que es gratis.

## Lo que necesitás

- La dirección del servidor: https://api.indumas.com/mcp
- Tu cuenta de indumás, la misma con la que ingresás al sitio. Es gratis y no hay claves.

## Instalación por cliente

### Claude y Claude Desktop

1. Abrí Configuración y entrá en Conectores.
2. Elegí Agregar conector personalizado.
3. Poné «indumás» como nombre, pegá la dirección https://api.indumas.com/mcp y guardá.
4. Claude abre una ventana de indumás: ingresá con tu cuenta y elegí Autorizar.
5. En una conversación, activá indumás en el menú de herramientas y pedile lo que necesitás.

Los conectores personalizados dependen de tu plan de Claude. En Team y Enterprise los agrega un administrador.

### Claude Code

En una terminal:

```bash
claude mcp add --transport http indumas https://api.indumas.com/mcp
```

Para tenerlo en todos tus proyectos:

```bash
claude mcp add --transport http --scope user indumas https://api.indumas.com/mcp
```

Después, dentro de Claude Code, /mcp → indumas → Authenticate: se abre indumás en el navegador para autorizar. /mcp muestra si está conectado.

### ChatGPT

1. En Configuración, entrá en Aplicaciones y conectores y activá el modo desarrollador en Configuración avanzada.
2. Creá un conector con el nombre «indumás», la dirección https://api.indumas.com/mcp y la autenticación en «OAuth».
3. ChatGPT abre una ventana de indumás: ingresá con tu cuenta y elegí Autorizar.
4. En una conversación, elegí indumás entre las herramientas y pedile lo que necesitás.

La disponibilidad de los conectores depende de OpenAI y de tu plan.

### Codex CLI

```bash
codex mcp add indumas --url https://api.indumas.com/mcp
```

La primera vez se abre indumás en el navegador para que autorices con tu cuenta.

### Cursor

1. Abrí Settings, entrá en MCP y elegí New MCP Server (o editá ~/.cursor/mcp.json).

Con esta configuración:

```json
{
  "mcpServers": {
    "indumas": {
      "url": "https://api.indumas.com/mcp"
    }
  }
}
```

Al conectarlo, Cursor abre indumás en el navegador para que autorices con tu cuenta.

### VS Code

1. Con GitHub Copilot en modo agente: en la paleta de comandos, MCP: Add Server, HTTP, y la dirección.

O en .vscode/mcp.json:

```json
{
  "servers": {
    "indumas": {
      "type": "http",
      "url": "https://api.indumas.com/mcp"
    }
  }
}
```

Al iniciarlo, VS Code abre indumás en el navegador para que autorices con tu cuenta.

### Otros clientes

1. Cualquier cliente MCP con Streamable HTTP y OAuth: la dirección https://api.indumas.com/mcp. El cliente se registra solo y abre indumás para que autorices con tu cuenta.

## Frases para probar

- «Buscá tornerías CNC en Neuquén con ISO 9001 y armá una tabla con lo que hace cada una.»
- «¿Quién hace mantenimiento de bombas para minería en San Juan?»
- «Compará tres proveedores de válvulas de Mendoza: qué hacen, dónde están y qué certificaciones tienen.»
- «¿Qué empresas participan en AOG Patagonia este año?»
- «¿Cuántos proveedores de petróleo y gas hay en Chubut?»
- «Pasame el enlace a indumás de la primera empresa de la lista.»

## Si algo no funciona

**El asistente no usa indumás.** Revisá que el conector esté activado en esa conversación y pedíselo en la frase: «buscá en indumás…».

**No se abre la ventana para autorizar.** Pedile al asistente que vuelva a conectarse (en Claude Code: /mcp, indumas, Authenticate). Revisá que la dirección sea exactamente https://api.indumas.com/mcp y, si el cliente lo pregunta, que la autenticación sea OAuth: indumás no usa claves.

**No encuentra una empresa.** Solo están las empresas publicadas en indumás. Si es la tuya, entrá en Sumá tu empresa: https://indumas.com/sumar-empresa.

**Dice que se alcanzó el límite.** Esperá un minuto y volvé a intentar. Si es el límite del día, volvé mañana: indumas.com tiene el mismo catálogo.

## Qué datos usa

El servidor lee el catálogo público de indumás, el mismo que ve cualquier visitante, y no guarda nada de tus conversaciones.

- Lee: empresas publicadas, sus certificaciones, rubros y organizaciones. Los contactos están en la página de cada empresa y organización, detrás de «Ver contacto».
- Nunca: números de CUIT, cuentas, empresas sin verificar u ocultas.
- Guarda: qué asistentes autorizó tu cuenta y cuántas consultas hacen, para el límite de uso, por 7 días; de la conexión, una huella sin la dirección IP.

## Nota técnica

- Servidor MCP: https://api.indumas.com/mcp
- Streamable HTTP sin estado (POST, respuestas JSON), solo lectura.
- Autenticación: OAuth 2.1 con PKCE (S256) y registro dinámico de clientes (RFC 7591), alcance catalog:read.
- Metadatos: https://api.indumas.com/.well-known/oauth-protected-resource/mcp (RFC 9728) y https://indumas.com/.well-known/oauth-authorization-server/api/oauth (RFC 8414).
- Herramientas: search_companies, get_company, list_categories, search_organizations, get_organization, get_catalog_overview.
- Server card: https://api.indumas.com/mcp/server-card
- AI catalog: https://indumas.com/.well-known/ai-catalog.json
- API catalog: https://indumas.com/.well-known/api-catalog
- llms.txt: https://indumas.com/llms.txt
- auth.md: https://indumas.com/auth.md

Más sobre el servidor: https://indumas.com/mcp
Esta guía en Markdown: https://indumas.com/docs/mcp.md