Servidor MCP · Model Context Protocol

Conecta FarmaCore AI con tu asistente de IA

Claude, ChatGPT, Codex o Cursor consultan tu organización en FarmaCore AI con tu propio usuario: cobertura, visitas, farmacias, productos y esquemas, con los mismos permisos que tienes en la app.

URL del servidor

https://mcp.farma-core.app/mcp

Transporte
Streamable HTTP
Autenticación
OAuth 2.1 · inicia sesión con tu cuenta
Alcance
Tu organización · tu rol

Cómo funciona

Tres pasos, sin claves que copiar

  1. Agrega la URL en tu cliente

    Cada cliente tiene un lugar para conectores MCP. Pegas la URL de arriba y nada más: no hay tokens ni secretos que pedir a nadie.

  2. Inicia sesión y elige tu organización

    El cliente te lleva a FarmaCore AI. Entras como siempre (correo o teléfono con código, o contraseña) y, si perteneces a varias organizaciones, eliges una.

  3. Autoriza y empieza a preguntar

    Revisas qué podrá hacer el asistente. "Permitir cambios" es opcional: sin marcarlo, la conexión es solo de consulta.

Acceso

¿Quién puede conectarse?

La conexión no crea permisos nuevos: usa los que ya tienes en FarmaCore AI. Para autorizar un cliente necesitas cumplir las cuatro condiciones.

  1. Una cuenta en FarmaCore AI

    La misma con la que entras a la app web o a la app móvil.

  2. Membresía activa en una organización activa

    Si tu administrador te desactiva, o la organización se suspende, la conexión deja de responder en la siguiente consulta.

  3. Un rol con acceso al Centro de Comando

    Propietario, administrador, manager, representante y marketing. El rol Lector no se conecta.

  4. Centro de Comando habilitado para tu organización

    Lo habilita KeyCore por contrato y, dentro de la organización, un administrador en Configuración → Organización → Funciones de IA. Si no está activo, al iniciar sesión verás que tu organización no es elegible.

Qué ve cada rol

Lo que el asistente puede consultar es exactamente lo que ves en la app.

  • Propietario y administradorToda la organización: visitas, cobertura, farmacias, catálogo de marketing. Con "Permitir cambios", también mover marcas en un esquema e importar farmacias.
  • ManagerSu territorio: los representantes que comparten región y línea con él, más el catálogo de marketing.
  • RepresentanteSolo sus propios registros: sus visitas, su cobertura, sus farmacias, más el catálogo de marketing.
  • MarketingProductos, marcas, listas de precios, esquemas promocionales y ayudas visuales. Sin datos de campo.
  • LectorNo puede conectar clientes MCP.

Guías por cliente

Configúralo donde trabajas

Los pasos cambian poco entre clientes: pegar la URL, iniciar sesión, autorizar. Elige el tuyo.

Claude

Web y escritorio
  1. En Claude, abre Personalizar → Conectores y pulsa "+ Añadir" → "Añadir conector personalizado".

  2. Nombre: FarmaCore AI. URL del servidor MCP:

    URL
    https://mcp.farma-core.app/mcp
  3. Revisa la autenticación detectada (OAuth) y continúa. En Autenticación elige "Iniciar sesión ahora"; en Cliente OAuth deja "Usar la identidad publicada de Claude" (o "Registrar automáticamente"). Pulsa Añadir.

  4. Inicia sesión con tu cuenta de FarmaCore AI, elige tu organización y autoriza. Desmarca "Permitir cambios" si solo quieres consultar.

  5. En un chat, pulsa "+" → Conectores y activa FarmaCore AI.

En planes Team y Enterprise, un propietario agrega el conector en Configuración de la organización → Conectores → Añadir → Personalizado → Web; después cada miembro pulsa "Conectar". Claude Desktop usa los mismos conectores de tu cuenta.

Claude Code

Terminal e IDE
  1. Registra el servidor desde la terminal:

    Terminal
    claude mcp add --transport http farmacore https://mcp.farma-core.app/mcp
  2. Dentro de Claude Code escribe /mcp, elige farmacore y pulsa "Authenticate". Se abre el navegador para iniciar sesión en FarmaCore AI y elegir tu organización.

  3. Listo: las herramientas de FarmaCore AI aparecen con el prefijo mcp__farmacore__.

ChatGPT

Modo desarrollador
  1. Activa el modo desarrollador: Ajustes → Apps y conectores → Ajustes avanzados → "Modo desarrollador". Disponible en Plus, Pro, Business, Enterprise y Edu; en Business y Enterprise lo habilita primero un administrador del workspace.

  2. En Apps y conectores pulsa Crear. Nombre: FarmaCore AI. Descripción: tu organización en FarmaCore AI. URL del servidor MCP:

    URL
    https://mcp.farma-core.app/mcp
  3. Autenticación: OAuth. Acepta el aviso y pulsa Crear.

  4. Autoriza con tu cuenta de FarmaCore AI y elige tu organización. En un chat, pulsa "+" → Más y elige FarmaCore AI.

Codex

CLI y app de escritorio
  1. Agrega el servidor y autentícate desde la terminal:

    Terminal
    codex mcp add farmacore --url https://mcp.farma-core.app/mcp
    codex mcp login farmacore
  2. En la app de escritorio: Settings → MCP servers → Add server → Streamable HTTP, pega la URL, guarda y pulsa "Authenticate".

  3. La configuración queda en ~/.codex/config.toml:

    config.toml
    [mcp_servers.farmacore]
    url = "https://mcp.farma-core.app/mcp"

Cursor

Editor
  1. Abre Cursor Settings → Tools & MCP → "New MCP server", o crea el archivo en tu proyecto:

    .cursor/mcp.json
    {
      "mcpServers": {
        "farmacore": { "url": "https://mcp.farma-core.app/mcp" }
      }
    }
  2. El servidor aparece como "Needs login": pulsa para iniciar sesión en FarmaCore AI y autorizar.

VS Code

GitHub Copilot
  1. Crea el archivo en tu espacio de trabajo (o usa "MCP: Add Server" desde la paleta de comandos):

    .vscode/mcp.json
    {
      "servers": {
        "farmacore": { "type": "http", "url": "https://mcp.farma-core.app/mcp" }
      }
    }
  2. Pulsa "Start" sobre el servidor, acepta la autenticación y autoriza en FarmaCore AI.

Otros clientes

Cualquier cliente MCP
  1. Sirve cualquier cliente que hable MCP sobre Streamable HTTP y OAuth 2.1 con registro dinámico de clientes y PKCE. Endpoint:

    URL
    https://mcp.farma-core.app/mcp
  2. El descubrimiento es estándar: tras el primer 401, el cliente lee los metadatos del recurso y encuentra el servidor de autorización.

    Metadatos del recurso
    https://mcp.farma-core.app/.well-known/oauth-protected-resource/mcp
  3. Pide los scopes mcp:read y, si vas a aplicar cambios, mcp:write. Envía el token como Bearer en la cabecera Authorization.

Qué puedes preguntar

Las mismas respuestas, en tu chat

  • ¿Cómo va mi cobertura médica en el ciclo actual?
  • Resume las visitas a farmacias de esta semana por cadena.
  • ¿Qué marcas están en el esquema de Cardiología en el ciclo 6?
  • Dame la lista de precios vigente de la línea 1.
  • ¿Qué ayudas visuales tiene la marca X este ciclo?

Herramientas disponibles

  • Quién soy y organización activa
  • Ciclos
  • Visitadores
  • Cobertura médica y reporte de cobertura
  • Visitas médicas: resumen y análisis
  • Visitas a farmacias: listado, resumen y análisis
  • Farmacias
  • Productos, marcas y listas de precios
  • Esquemas promocionales y ayudas visuales
  • Con cambios: mover una marca en un esquema (con vista previa), importar farmacias

Seguridad

Lo que la conexión no hace

Detalles técnicos

Para quien configura el cliente a mano

Endpoint
https://mcp.farma-core.app/mcp
Transporte
Streamable HTTP (POST). Sin SSE de larga duración.
Autorización
OAuth 2.1 con registro dinámico de clientes y PKCE. Bearer en la cabecera Authorization.
Descubrimiento
https://mcp.farma-core.app/.well-known/oauth-protected-resource/mcp
Scopes
mcp:read (consulta) · mcp:write (cambios)
Versiones MCP
2025-03-26 · 2025-06-18 · 2025-11-25 · 2026-07-28
FarmaCore AI · Servidor MCP