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. Elige tu variante: en claude.ai basta con la URL del servidor —te identificas con tu usuario de Afer y no hace falta ninguna clave—; en Claude Desktop, Claude Code y la API de Anthropic necesitas tus claves API (Afer → Integraciones).

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

Desde claude.ai y Claude Desktop (conector personalizado)

Ve a Ajustes → Conectores → Añadir conector personalizado. El formulario tiene cuatro campos y solo se rellenan los dos primeros:

`Nombre`tú eliges	Lo que verás en tu lista de conectores. Por ejemplo `Afer`.
`URL del servidor MCP remoto`obligatorio	`https://api.afer.pro/mcp/` — con la barra final, y con el dominio .pro. Sin la barra, el servidor responde una redirección que los clientes MCP no siguen.
`OAuth Client ID`déjalo vacío	No pongas nada. Nuestro servidor admite registro dinámico: Claude se da de alta solo al conectar y se genera su propio identificador.
`Secreto del Cliente OAuth`déjalo vacío	Tampoco pongas nada. Claude se registra como cliente público con PKCE, que no usa secreto.

Pulsa Añadir y luego Conectar. Claude te traerá a Afer para que inicies sesión, elijas la empresa y apruebes los permisos. A partir de ahí la conexión aparece en Afer → Integraciones, donde puedes retirarla cuando quieras.

Tus claves API NO van en este formulario

Es la confusión más habitual: OAuth Client ID y Secreto del Cliente OAuth no son tu afer_tk_… y tu afer_sk_… de Integraciones. Son dos sistemas de credenciales distintos. Si pegas ahí tu clave API verás "Cliente no reconocido" al conectar, y además Claude se saltará el registro automático. Déjalos vacíos.

Alternativa: con tu clave API, si tu cuenta muestra "Request headers"

Algunas cuentas ven además una sección Request headers en ese mismo diálogo. Si es tu caso y prefieres no pasar por OAuth, deja los dos campos de OAuth vacíos igualmente y 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"?

Es normal: Anthropic la despliega de forma gradual y muchas cuentas aún no la tienen. No necesitas esperarla — conecta con OAuth como se explica arriba, que funciona en todas las cuentas. También puedes usar mcp-remote en Claude Desktop o 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.