Servidor MCP

Conecta tus flujos y agentes actuales con AymarTech MCP

El cliente que ya usas puede cambiar una portada, corregir un artículo o revisar la indexación. AymarTech ejecuta la acción que tu token permite.

AymarTech MCP

Tú

Cambia la foto de portada del artículo que publicamos hoy. Que sea un escritorio luminoso, el producto a la izquierda y un titular corto en los colores de nuestra marca.

Qué es MCP

MCP es cómo Claude, ChatGPT o el agente que ya usas hace trabajo dentro de AymarTech. Pides con una frase. El cliente llama a la herramienta de AymarTech que corresponde. AymarTech ejecuta esa acción cuando tu token la permite y guarda el registro.

Cómo conectarlo

Crea un token en tu acceso de AymarTech

Ponle nombre y deja solo los scopes que ese cliente necesita. Puedes limitarlo a proyectos concretos y poner una caducidad. AymarTech muestra el secreto una vez. Empieza por aym_mcp_. AymarTech guarda solo un hash.

Apunta el cliente a este servidor

En Claude, ChatGPT u otro cliente MCP, añade un servidor remoto propio. URL: https://app.aymar.tech/mcp. Cabecera: Authorization: Bearer y después el token. No es una instalación de una tienda de apps.

Pide en el chat que ya usas

El cliente solo llama a las herramientas de ese token. Entrar en WordPress, Shopify, Webflow o Google sigue ocurriendo en AymarTech, y lo haces tú.

Revoca el token para desconectar

Revócalo en ese acceso de AymarTech, o deja que pase la fecha de caducidad. La siguiente petición se detiene antes de que corra ninguna herramienta.

La dirección que necesita tu cliente

El servidor habla Streamable HTTP. Envía el token en cada petición como credencial bearer. El secreto siempre empieza por aym_mcp_.

Dirección del servidor

https://app.aymar.tech/mcp

Cabecera Authorization

Authorization: Bearer aym_mcp_…

Sustituye aym_mcp_… por el token de tu acceso a AymarTech. No envíes la clave API del proyecto. Esa clave no se acepta como autenticación MCP.

{
  "mcpServers": {
    "aymartech": {
      "url": "https://app.aymar.tech/mcp",
      "headers": {
        "Authorization": "Bearer aym_mcp_…"
      }
    }
  }
}

Qué puedes pedir

Estos son prompts que escribiría una persona. Debajo de cada uno está la herramienta real que usa el cliente y el scope que esa herramienta exige.

Corregir un artículo

El artículo de onboarding suena rígido. Reescribe la introducción con nuestra voz de marca y deja el resto del post como está.

El cliente guarda el artículo revisado con update_article. Editar no publica por sí solo. Si el artículo ya está en vivo, el guardado puede sincronizarse con tu CMS, y esa sincronización hay que comprobarla antes de dar la página pública por actualizada.

Usa

  • update_article · content:write

Añadir una sección

Añade al comparador de CRM una sección que explique cómo se suele estructurar el precio. Mantén el título actual.

No hay una acción aparte de “añadir una sección”. El cliente lee el artículo y guarda la versión completa revisada, incluida la sección nueva, con update_article.

Usa

  • update_article · content:write

Cambiar un título

Cambia el título del artículo de ayer a “Una forma más simple de incorporar usuarios nuevos”.

update_article puede cambiar el título, el slug y los campos SEO sin reescribir el cuerpo.

Usa

  • update_article · content:write

Comprobar el estado de indexación

¿Google ha aceptado una solicitud de indexación del artículo de onboarding y la URL en vivo está confirmada?

Esa pregunta es una lectura. get_publication_status informa del ciclo del proveedor, la URL en vivo confirmada y los puntos de indexación. Pedirle al cliente que solicite indexación es otra acción, request_article_indexing, y exige publishing:write. Que Google acepte la solicitud no es lo mismo que indexar la página.

Usa

  • get_publication_status · content:read

Ajustar el plan de contenido

Mira el plan de la semana que viene. Quita el consejo genérico de CRM y pasa el tema de onboarding al lunes.

Leer el plan usa list_article_suggestions. Rechazar, editar o reprogramar una sugerencia que aún no se ha generado usa update_article_suggestion. Un calendario nuevo es request_content_plan, que exige planning:write y no gasta por sí solo un crédito de artículo.

Usa

  • list_article_suggestions · content:read + projects:read
  • update_article_suggestion · content:write

Herramientas y los scopes que exigen

Cada nombre de abajo es una herramienta que registra el servidor MCP de AymarTech, con el scope que se comprueba antes de ejecutarse. Si falta el scope, la llamada se detiene. La comprobación no se salta.

Un token nuevo incluye estos scopes y no incluye facturación: projects:read, projects:write, content:read, content:write, planning:write, generation:write, publishing:write, monitoring:read, integrations:write, social:write, uploads:write, monitoring:write

Ver tus proyectos

projects:read

Buscar proyectos que este acceso ya puede abrir, leer el perfil de negocio y SEO, ver qué falta de la configuración y comprobar si un proveedor está conectado. Las credenciales no se incluyen.

No crea un proyecto, no cambia ajustes y no revela contraseñas del CMS, tokens OAuth ni secretos de webhook.

  • list_projects
    projects:read
  • get_project_context
    projects:read
  • get_project_setup_status
    projects:read
  • get_agent_workflow
    projects:read
  • get_next_actions
    projects:read
  • get_usage_and_costs
    projects:read
  • get_integration_guide
    projects:read
  • get_integration_status
    projects:read
  • list_integration_targets
    projects:read
  • test_integration
    projects:read

Configurar un proyecto

projects:write

Crear un proyecto, actualizar su perfil, responder preguntas de configuración y fijar el calendario, las traducciones y la publicación automática.

No publica un artículo. La publicación automática se rechaza hasta que el destino elegido esté conectado. Un token limitado a una lista fija de proyectos no puede crear un proyecto.

  • create_project
    projects:write

    No disponible cuando el token está limitado a una lista fija de proyectos.

  • configure_project
    projects:write
  • configure_automation
    projects:write
  • start_project_setup
    projects:write
  • answer_project_setup_questions
    projects:write

Leer contenido y estado

content:read

Leer el plan de contenido, los artículos, las traducciones, las imágenes, el avance de la generación y si una publicación llegó de verdad a estar en vivo.

No edita un artículo, no sustituye una imagen y no cambia lo que está publicado.

  • list_article_suggestions
    content:read

    También necesita projects:read.

  • list_articles
    content:read

    También necesita projects:read.

  • get_generation_status
    content:read
  • get_article
    content:read
  • list_article_images
    content:read
  • get_article_image_status
    content:read
  • get_publication_status
    content:read
  • list_project_knowledge
    content:read
  • list_article_translations
    content:read
  • get_article_translation
    content:read
  • get_instagram_profile
    content:read
  • list_instagram_posts
    content:read
  • get_instagram_publication_status
    content:read

Editar contenido

content:write

Actualizar el texto del artículo y los campos SEO, importar un artículo, archivar un artículo no publicado, editar traducciones y cambiar palabras clave, enlaces internos y productos.

No publica, despublica ni programa. Eso queda en publishing:write, o en social:write para un proyecto de Instagram.

  • update_article
    content:write
  • create_article
    content:write
  • archive_article
    content:write
  • update_article_suggestion
    content:write
  • request_article_translations
    content:write
  • update_article_translation
    content:write
  • retry_article_translation
    content:write
  • archive_article_translation
    content:write
  • replace_article_image
    content:write

    Herramienta de compatibilidad antigua. Prefiere create_asset_upload y complete_asset_upload.

  • regenerate_article_image
    content:write

    También necesita generation:write y usa un crédito de AymarTech.

  • upsert_project_keyword
    content:write
  • archive_project_keyword
    content:write
  • upsert_internal_link
    content:write
  • set_internal_link_enabled
    content:write
  • upsert_product
    content:write
  • set_product_enabled
    content:write
  • archive_product_image
    content:write
  • reorder_product_images
    content:write

Poner en cola un plan de contenido

planning:write

Pedir a AymarTech que arme un calendario de contenido nuevo para un proyecto que ya está configurado.

No gasta por sí solo un crédito de artículo y no publica las sugerencias.

  • request_content_plan
    planning:write

Iniciar la generación

generation:write

Empezar un artículo a partir de un tema que nombras, o de una sugerencia que ya está en el plan. Una generación nueva usa un crédito de AymarTech.

No edita un artículo existente. Regenerar una imagen también exige content:write y usa un crédito propio.

  • request_article_generation
    generation:write
  • generate_article_from_suggestion
    generation:write
  • regenerate_article_image
    generation:write

    También necesita content:write y usa un crédito de AymarTech.

Cambiar lo que está en vivo

publishing:write

Publicar, actualizar o despublicar un artículo de blog, programarlo, fijar la política de publicación del blog y poner en cola una solicitud de la Indexing API de Google para una URL publicada.

Una publicación en cola no es una página en vivo. Comprueba get_publication_status. Que Google acepte un aviso de indexación no es lo mismo que indexar la página. Los enlaces de demo públicos exigen un token de administrador de toda la plataforma.

  • request_article_publication
    publishing:write
  • schedule_article
    publishing:write
  • request_article_indexing
    publishing:write
  • configure_publication_policy
    publishing:write

    Proyectos de blog. Un proyecto de Instagram necesita social:write.

  • approve_channel_autonomy
    publishing:write

    Proyectos de blog. Un proyecto de Instagram necesita social:write.

  • set_article_demo_status
    publishing:write

    Solo un token de administrador de toda la plataforma.

Leer el estado operativo

monitoring:read

Leer una instantánea de la configuración, las generaciones, la publicación, los incidentes, las notificaciones y las escrituras MCP recientes.

No reintenta trabajo ni cambia contenido.

  • get_operations_overview
    monitoring:read

Reintentar y revisar la calidad

monitoring:write

Reintentar un flujo de configuración fallido y ejecutar la revisión de calidad previa a la publicación. Esa revisión no usa un crédito.

No publica el artículo.

  • retry_agent_operation
    monitoring:write
  • request_article_quality_check
    monitoring:write

Cambiar una conexión

integrations:write

Elegir un destino de publicación que ya está autorizado, apagar un proveedor para el proyecto y enviar un sitemap cambiado a Search Console.

No inicia sesión en WordPress, Shopify, Webflow, Google ni ningún otro proveedor. Esas conexiones las sigues aprobando en AymarTech. Un envío de sitemap se limita a uno por proyecto cada 24 horas y no significa que el artículo se haya indexado.

  • select_integration_target
    integrations:write
  • disable_integration
    integrations:write
  • submit_updated_sitemap
    integrations:write

Llevar un proyecto de Instagram

social:write

En un proyecto de Instagram, actualizar el perfil, planificar y generar posts, editar borradores, programarlos y solicitar la publicación.

No adjunta Instagram a un proyecto de blog. Un negocio que hace las dos cosas usa dos proyectos. La publicación del blog usa publishing:write, no este scope.

  • update_instagram_profile
    social:write
  • request_instagram_plan
    social:write
  • request_instagram_generation
    social:write
  • create_instagram_post
    social:write
  • update_instagram_post
    social:write
  • archive_instagram_post
    social:write
  • schedule_instagram_post
    social:write
  • request_instagram_publication
    social:write
  • configure_publication_policy
    social:write

    Proyectos de Instagram. Un proyecto de blog necesita publishing:write.

  • approve_channel_autonomy
    social:write

    Proyectos de Instagram. Un proyecto de blog necesita publishing:write.

Subir una imagen

uploads:write

Reservar un enlace de subida de corta duración para un JPEG, PNG o WebP, y validar y adjuntar el archivo después de subirlo.

No publica el artículo al que pertenece la imagen.

  • create_asset_upload
    uploads:write
  • complete_asset_upload
    uploads:write

Leer facturación

billing:read

Con un token de administrador de toda la plataforma, buscar clientes y leer un perfil de facturación.

No está incluido en un token de cuenta normal. Un usuario con sesión iniciada no puede concederse este scope.

  • search_billing_customers
    billing:read
  • get_billing_customer
    billing:read

Cambiar la facturación

billing:write

Con un token de administrador de toda la plataforma, crear un cliente de facturación, actualizar la suscripción local y registrar un pago.

No está incluido en un token de cuenta normal. Estas herramientas no se registran si el token no tiene acceso de administrador de toda la plataforma.

  • create_billing_customer
    billing:write
  • update_billing_customer
    billing:write
  • update_billing_subscription
    billing:write
  • record_billing_payment
    billing:write

Un cliente de IA puede escribir en tu sitio

Un token es el permiso que le das a ese cliente. Esto es lo que un token normal de AymarTech puede cambiar, lo que no puede alcanzar, dónde queda el registro y cómo lo retiras.

Qué puede hacer

Un token nuevo incluye los scopes del plano de control y deja fuera la facturación. En los proyectos que ese acceso ya puede abrir, el cliente puede editar un artículo, su título y su portada, poner en cola un plan de contenido y empezar una generación. Una generación usa un crédito de AymarTech. Publicar, despublicar o programar un artículo de blog también exige publishing:write. Un proyecto de Instagram usa social:write para ese tipo de cambio. El dueño del proyecto puede hacerlo. Un permiso de viewer puede leer. Un permiso de editor o admin puede cambiar el proyecto.

Qué no puede hacer

No puede leer una contraseña del CMS, un token OAuth, un secreto de webhook ni la clave API del proyecto. Esa clave API no puede iniciar sesión en MCP. content:write edita un artículo y no lo publica. El cliente no puede terminar un inicio de sesión en WordPress, Shopify, Webflow o Google. Eso lo haces tú en AymarTech. Un límite de proyectos solo quita proyectos. Las herramientas de facturación no están en un token normal. Un proyecto es de blog o de Instagram, no las dos cosas. Una publicación en cola, una solicitud de indexación aceptada y un envío de sitemap aceptado hay que comprobarlos con get_publication_status antes de dar la página pública por cambiada.

Cómo ves lo que hizo

Cada escritura queda en el token que la hizo: el nombre de la herramienta, el proyecto, el estado y la hora. El texto del artículo y los secretos no se guardan en ese registro. El token muestra cuándo se usó por última vez. Con monitoring:read, get_operations_overview lista las escrituras recientes de ese token en un proyecto — herramienta, estado, error y marcas de tiempo — más los comandos de publicación y si una URL en vivo está confirmada. La lista es del token que pregunta, no de todos los tokens de la cuenta.

Cómo revocas el acceso

Revoca el token en el acceso de AymarTech al que pertenece. La siguiente petición falla antes de que MCP arranque y antes de que corra ninguna herramienta. Un token caducado falla igual. Borrar el chat en Claude o ChatGPT deja el token en vigor.

Preguntas

Es la conexión que permite a Claude, ChatGPT u otro cliente MCP llamar a AymarTech en tu nombre. Pides en lenguaje natural. El cliente usa las herramientas de AymarTech. AymarTech solo permite lo que autorizan los scopes de ese token y tu rol en el proyecto.

Añade un servidor MCP remoto propio en https://app.aymar.tech/mcp y envía Authorization: Bearer más tu token aym_mcp_. AymarTech no publica un plugin aparte de tienda. El cliente tiene que admitir un servidor MCP remoto con esa cabecera.

Solo si el token incluye publishing:write para un proyecto de blog, o social:write para un proyecto de Instagram, y tu rol en ese proyecto puede publicar. Una petición en cola no es una URL en vivo. El cliente debería leer get_publication_status antes de dar la página por publicada.

Revoca el token de ese acceso de AymarTech. Los tokens revocados y caducados se rechazan antes de que corra ninguna herramienta. Borrar el chat en Claude o ChatGPT no revoca el token. El token sí.

No. request_article_indexing pone en cola un aviso de la Indexing API de Google por artículo cada 24 horas, y exige publishing:write. get_publication_status muestra qué ocurrió después. Que Google acepte el aviso es un estado distinto de rastrear o indexar la página.

Tu panel, en el chat que ya usas

Conecta AymarTech a un cliente MCP