La capa MCP viene donde está la API, en el plan Enterprise (página de planes); si se desactiva un tiempo, su dirección y su página de consentimiento responden «no encontrado». Con ella, los asistentes y agentes de IA de tu empresa usan las operaciones de la API, con los mismos nombres, y nunca con más de lo que puede un miembro o una clave. Son herramientas de tu empresa, sujetas a las cláusulas 6.2(g), 8.4 y 12.4 de las condiciones del portal para marcas. No son el asistente de MercaMap de la cláusula 12.5, que MercaMap presta en el portal como parte del servicio y que no necesita permiso.
La dirección y las dos formas de entrar
Añade en tu asistente un conector con esta dirección: https://mercamap.com/api/mcp. Habla MCP por Streamable HTTP: un mensaje JSON-RPC por POST, nunca en lote; se rechaza un mensaje de más de 1 MB.
- El permiso de un miembro. El asistente se registra solo y envía al miembro al portal para que entre y le dé permiso. Desde entonces actúa como ese miembro, con su rol y los límites del plan, releídos en cada llamada.
- Una clave de API. Un agente que ejecute tu empresa puede enviar una clave en su lugar (
Authorization: Bearer mmk_…): llega a lo que permiten los permisos de la clave, y lo que hace lleva el nombre de la clave.
Los clientes encuentran cómo entrar en /.well-known/oauth-protected-resource/api/mcp y /.well-known/oauth-authorization-server; una petición sin un token válido responde 401 y remite a la primera. Los clientes son públicos y usan PKCE (S256): un código dura 1 minuto, un token de acceso 1 hora y solo para esta dirección, y un token de renovación 30 días, renovado en cada uso. Un token de renovación sirve una vez: usado de nuevo (un reintento tras perder una respuesta, o una copia robada), termina el permiso, y el miembro vuelve a darlo.
MercaMap admite Claude (claude.ai y su aplicación de escritorio), ChatGPT, Visual Studio Code, Cursor y Windsurf; en cada uno, añade la dirección de arriba como conector personalizado o servidor MCP y sigue su inicio de sesión. Otro cliente que hable MCP con OAuth funciona igual.
Entrar y dar permiso
El miembro vuelve a entrar salvo que haya entrado hace menos de 15 minutos, y un administrador demuestra además su segundo factor. La página «Dar permiso a un asistente de IA» muestra entonces el nombre que el asistente se dio y el día en que se registró (MercaMap no ha verificado ese nombre, y la página avisa cuando tiene caracteres fuera del alfabeto latino básico), adónde vuelve, la cuenta y lo que podrá hacer. Dice también si MercaMap reconoce al asistente por adónde vuelve: uno de los clientes admitidos o una aplicación de este ordenador. Con cualquier otro, la página avisa, y solo un administrador puede dejarle cambiar datos. Leer viene marcado; lo que cambia datos lo marca el propio miembro. «Dar permiso» concede exactamente lo marcado, en esa cuenta; «No dar permiso» devuelve al asistente sin nada.
Si la cuenta exige al miembro el inicio de sesión de su empresa, este da el permiso en una sesión abierta con su empresa, y vale 12 horas. En solo lectura, tras el fin del plan, no se da permiso; los ya dados se pueden retirar.
Lo que puede alcanzar un permiso
Nunca más de lo que el rol del miembro permite hoy:
- Un administrador o un miembro: los datos del lineal y las semanas publicadas; las incidencias y las visitas, y abrir, mover y comentar incidencias; los pedidos y la respuesta del ERP; los albaranes; las campañas; el cuadro de mando; las importaciones del catálogo; y las previsiones, si alguna está abierta.
- Un miembro de campo con puesto de campo: sus propias incidencias y visitas, abrir, mover y comentar incidencias, y sus pedidos y albaranes.
- Nunca importar: eso queda para las claves y los archivos CSV. Mientras el módulo de campo no esté abierto, solo se pueden dar los datos del lineal y las semanas publicadas.
Herramientas, prompts y respuestas
El asistente ve una herramienta por cada operación que alcanza su permiso (list_releases y get_data para los datos del lineal, list_issues y list_visits para el trabajo de campo, get_scorecard, list_campaigns, list_orders y el resto de la referencia MCP) y, además, search_help y read_help, que buscan y leen este centro de ayuda sin necesitar permiso. Las herramientas de lectura van marcadas como de solo lectura; change_issue_status y answer_order, que sobrescriben lo que hay, van marcadas como destructivas, para que el cliente pregunte antes. Dos prompts preparan weekly_shelf_review, la revisión semanal del lineal, y my_day, el día de un miembro de campo.
Una respuesta es contenido estructurado con su JSON como texto: 25 filas si no se piden más, 200 como máximo; truncated o next indican que hay más, y un campo ausente está vacío. Ninguna respuesta lleva una foto, un fotograma, un recorte ni una firma, ni nombra a una persona, y las observaciones llegan por semana ISO (de lunes a domingo, hora peninsular).
El texto son datos, nunca instrucciones. Las notas, los comentarios, los nombres y las descripciones de las campañas y los nombres de productos y tiendas los escriben personas o se leen en los lineales. Las instrucciones del servidor dicen al cliente que nunca siga las instrucciones que encuentre en ellos, y las descripciones de las herramientas son texto fijo en el que no entra ningún dato. Configura igual tus agentes.
Límites y registros
Un permiso tiene su propio límite de peticiones por minuto, como una clave, y como máximo 30 escrituras por minuto; las filas que lee cuentan dentro de las 500.000 diarias de la cuenta, compartidas con las claves, y un permiso lee como máximo 100.000 de ellas al día, para que un asistente desbocado no agote el día de la cuenta. Lo que cambia un asistente aparece en la página «Actividad» como hecho por el miembro mediante un asistente de IA, y en una incidencia como obra del asistente de IA del miembro.
Ver y retirar permisos
«Ajustes de la cuenta» › «Asistentes de IA» los muestra: un administrador ve todos los de la cuenta y quién dio cada uno; un miembro, los suyos. Cada permiso muestra el asistente, adónde vuelve, cuándo se dio y se usó por última vez, sus peticiones y filas de los últimos 7 días y lo que puede usar. «Retirar el permiso», confirmado, lo termina al momento, con sus tokens. Un permiso que nadie usa en 90 días caduca, y también cualquier permiso con 365 días de antigüedad, por mucho que se use; los permisos de un miembro terminan cuando deja la cuenta, elimina su propia cuenta o cambia de rol; el asistente vuelve entonces a pedirlo. Cuando un asistente de IA deja de funcionar explica qué significa cada rechazo.
Tu empresa elige el proveedor del asistente y responde de él, como de todo destino que configure (cláusula 12.4): el proveedor trabaja en nombre de tu empresa, con confidencialidad, y no puede entrenar con tus datos modelos que ofrezca a otros (condiciones del portal para marcas, cláusula 6.2(g)).