Conectar Claude

Conecta Claude a tu cuenta de Afer a través del servidor MCP y pregúntale por tus ventas, tesorería, stock o CRM en lenguaje natural. Necesitas tus claves API (Afer → Integraciones) y elegir tu variante: claude.ai, Claude Desktop, Claude Code o la API de Anthropic.

MCP https://api.afer.pro/mcp/

Desde claude.ai y Claude Desktop (conector personalizado)

En Ajustes → Conectores → Añadir conector personalizado introduce la URL https://api.afer.pro/mcp/ y, en la sección Request headers, añade la cabecera Authorization con el valor completo (incluido el prefijo Bearer ):

Request header del conector

Authorization: Bearer afer_tk_TU_TOKEN.afer_sk_TU_SECRET

¿No ves la sección "Request headers"?

Anthropic está desplegando esa opción de forma gradual (está en beta). Si tu cuenta de Claude aún no la muestra, conecta mientras tanto con mcp-remote en Claude Desktop o con Claude Code.

Desde Claude Desktop con mcp-remote

Alternativa universal para Claude Desktop (necesita Node.js instalado). Edita el fichero de configuración (Ajustes → Desarrollador → Editar configuración, claude_desktop_config.json) y añade:

{
  "mcpServers": {
    "afer": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://api.afer.pro/mcp/",
        "--header", "X-API-KEY: afer_tk_TU_TOKEN",
        "--header", "X-API-SECRET: afer_sk_TU_SECRET"
      ]
    }
  }
}

Reinicia Claude Desktop después de guardar: verás las herramientas de Afer en el menú de conectores. La clave "afer" es el nombre de la conexión; si llevas varias cuentas, repite el bloque con otra clave y sus propias credenciales — más abajo.

Desde Claude Code

La palabra que va justo después de add —aquí afer— es el nombre de la conexión. Es tuyo: elígelo como quieras.

claude mcp add --transport http afer https://api.afer.pro/mcp/ \
  --header "X-API-KEY: afer_tk_TU_TOKEN" \
  --header "X-API-SECRET: afer_sk_TU_SECRET"

Comprueba la conexión con el comando /mcp dentro de Claude Code: el servidor afer debe aparecer como conectado, con sus herramientas listadas.

Varias cuentas a la vez

Si llevas más de una empresa, conecta cada una con su propio nombre y sus propias claves. Claude Code las mantiene como servidores independientes, así que puedes pedirle datos de una u otra sin que se mezclen — y en /mcp ves cuál es cuál.

# Una conexión por cuenta, cada una con su nombre
claude mcp add --transport http afer-ferrer https://api.afer.pro/mcp/ \
  --header "X-API-KEY: afer_tk_LA_DE_FERRER" \
  --header "X-API-SECRET: afer_sk_LA_DE_FERRER"

claude mcp add --transport http afer-mondaventura https://api.afer.pro/mcp/ \
  --header "X-API-KEY: afer_tk_LA_DE_MONDAVENTURA" \
  --header "X-API-SECRET: afer_sk_LA_DE_MONDAVENTURA"

# Ver las que tienes
claude mcp list

Cómo elegir el nombre

Solo letras, números y guiones, sin espacios ni acentos.
Tiene que ser único: repetir un nombre sobrescribe la conexión anterior.
Es el prefijo que verás en las herramientas (afer-ferrer · consultar_ventas), así que un nombre corto y reconocible te ahorra confusiones cuando le pides algo al asistente.
El nombre es solo tuyo: la cuenta sobre la que se opera la deciden las claves, no el nombre. Ponerle afer-ferrer a las claves de otra empresa no cambia a qué datos accede.
Para quitar una conexión, desconectar.

En Claude Desktop el nombre es la clave del objeto mcpServers del JSON de configuración: repite el bloque con otra clave y otras credenciales para añadir una segunda cuenta.

Desde la API de Anthropic (para desarrolladores)

Si construyes tu propia aplicación sobre la API de Claude, puedes darle acceso a Afer con el conector MCP de la Messages API (cabecera beta mcp-client-2025-11-20):

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 2000,
    "messages": [{"role": "user", "content": "¿Cómo va el mes?"}],
    "mcp_servers": [{
      "type": "url",
      "url": "https://api.afer.pro/mcp/",
      "name": "afer",
      "authorization_token": "afer_tk_TU_TOKEN.afer_sk_TU_SECRET"
    }],
    "tools": [{"type": "mcp_toolset", "mcp_server_name": "afer"}]
  }'

Probar la conexión

Pídele a Claude: «¿Qué herramientas de Afer tienes disponibles?» y después «Dame el resumen del mes». Si responde con tus cifras, la conexión está viva. Tienes la lista completa de herramientas y las notas de seguridad en la página general del MCP.

Desconectar

Para quitar la conexión de Claude Code basta con el nombre que le pusiste al añadirla. Si no recuerdas cuál era, claude mcp list te los enseña.

# Ver qué conexiones tienes
claude mcp list

# Ver el detalle de una (URL, cabeceras, ámbito)
claude mcp get afer

# Quitarla
claude mcp remove afer

Si la añadiste con un ámbito concreto (--scope user o --scope project) y quieres asegurarte de que la borra del sitio correcto, dile cuál: claude mcp remove afer --scope user. Sin --scope, Claude Code la busca en el ámbito donde exista.

En Claude Desktop se borra el bloque de esa conexión del objeto mcpServers del JSON de configuración y se reinicia la aplicación. En claude.ai, desde Ajustes → Conectores, con el botón de eliminar del conector.

Quitar la conexión no invalida tus claves

claude mcp remove borra la configuración de tu ordenador: la clave API sigue viva y sigue sirviendo para la API REST y para cualquier otro asistente donde la hubieras puesto. Si lo que quieres es cortar el acceso de verdad —porque cambia quien lleva la cuenta, porque sospechas que la clave se ha filtrado o porque desconectas a un colaborador— revócala en Afer, en Configuración → Integraciones → API de Afer. Al revocarla deja de funcionar en el momento, en todas partes.

Si solo quieres renovar la credencial sin cortar el servicio, rótala en vez de revocarla: el token se mantiene y solo tienes que actualizar la secret donde la uses.