Link building desde tu asistente de IA

Conexión

Autenticación

El servidor autentica a los clientes con OAuth 2.1. Una llamada sin token recibe un 401 que remite al cliente a https://tool.growwer.com/.well-known/oauth-protected-resource/mcp, los metadatos del recurso protegido (RFC 9728), que indican el servidor de autorización de Growwer (RFC 8414). El cliente se registra con un documento de metadatos de cliente (client ID metadata document), la vía preferida, o mediante registro dinámico, inicia sesión con PKCE S256 e indica la URL del servidor como recurso (RFC 8707); la respuesta incluye iss (RFC 9207).

Cada conexión la apruebas en Growwer después de iniciar sesión por completo: si tenías la sesión recordada, se te pide que vuelvas a iniciarla. La página de consentimiento muestra el cliente, el host que sirvió su documento de metadatos (o «No verificado» si el cliente se registró sobre la marcha) y el host al que vuelve.

Una conexión de lectura que llama a una herramienta de escritura recibe 403 insufficient_scope y no se ejecuta nada. Si el cliente lo admite, te pide entonces que apruebes el acceso de escritura.

Growwer te envía un email cada vez que se conecta un cliente. Una conexión no caduca: dura hasta que la revocas en la página MCP de tu cuenta, que lista tus conexiones, y a partir de ahí su siguiente llamada recibe un 401.

Un cliente que no puede iniciar sesión con OAuth puede enviar en su lugar una clave de API en la cabecera Authorization. Créala en la página de claves de API de tu cuenta; la página MCP muestra la configuración de cada cliente con cualquiera de los dos métodos.

Configuración por cliente

Todos los clientes se conectan solo con la URL del servidor y te llevan a Growwer para iniciar sesión la primera vez que lo usan, o tras el comando de inicio de sesión que verás abajo. Elige el tuyo para ver su configuración exacta, la misma que muestra la página MCP de tu cuenta.

https://tool.growwer.com/mcp

https://tool.growwer.com/mcp

claude mcp add --transport http growwer https://tool.growwer.com/mcp

/mcp

{
    "mcpServers": {
        "growwer": {
            "url": "https://tool.growwer.com/mcp"
        }
    }
}

[mcp_servers.growwer]
url = "https://tool.growwer.com/mcp"

codex mcp login growwer

{
    "servers": {
        "growwer": {
            "type": "http",
            "url": "https://tool.growwer.com/mcp"
        }
    }
}

{
    "mcpServers": {
        "growwer": {
            "httpUrl": "https://tool.growwer.com/mcp"
        }
    }
}

/mcp auth growwer

Herramientas

69 herramientas: una por cada operación de la API de Growwer, con el nombre growwer_ más la operación, y growwer_get_guide, que explica los perfiles de comprador y vendedor, los estados de los pedidos, los códigos de error y de dónde salen los identificadores del vocabulario. Los resultados tienen la forma de los recursos de la API, con su paginación, y los errores llevan los códigos de la API, como catalogue_daily_cap_reached o price_changed.

Los pedidos gastan fondos reales del monedero. Hacer o cancelar un pedido, aprobar una entrega, con lo que se paga al vendedor, rechazar un pedido que vendes, eliminar un proyecto o un medio que vendes y decidir sobre propuestas te piden confirmación antes, en un formulario que muestra lo que va a pasar y, cuando se mueve dinero, el importe y tu saldo. No pasa nada si no aceptas. Si tu cliente no puede mostrar ese formulario, no pasa nada y recibes un enlace para terminar en growwer.com. Las demás escrituras, como eliminar un filtro guardado, se ejecutan sin formulario. Las recargas y las retiradas de fondos se hacen en growwer.com.

Los nombres y las descripciones de las herramientas y los prompts salen del catálogo del servidor, que se publica en inglés.

General

Guide

Account

Files

Buyer

Projects

Catalogue

Saved filters

Buyer orders

Buyer wallet

Managed services

Seller

Seller account

Seller medias

Seller orders

Seller wallet

Prompts

6 prompts guían a tu asistente paso a paso por los flujos más habituales.

Límites

El MCP comparte los límites de tu API, así que las llamadas REST y MCP cuentan juntas.

• Cada llamada a una herramienta gasta una petición del presupuesto por minuto: 600 por minuto por usuario y 300 por conexión o clave de API. Si lo superas, la herramienta responde rate_limit_exceeded.
• Conectarse, listar las herramientas y leer la guía no tienen límite.
• El catálogo cuenta los medios distintos que devuelve por usuario y día (UTC): hasta 5.000, o 100 mientras tu cuenta no tenga ningún pedido entregado en los últimos 180 días. Si lo superas, la herramienta responde catalogue_daily_cap_reached.
• Cada escritura lleva un requestId de 8 a 128 caracteres, como un UUID. Si lo repites con los mismos argumentos después de que la escritura salga bien, recibes ese mismo resultado durante 30 días, así que una llamada reintentada nunca hace un pedido dos veces; con otros argumentos, la herramienta responde idempotency_key_reused.
• growwer_upload_file admite archivos de hasta 3.000.000 bytes; los más grandes se suben con la API.

Soporte

¿Dudas sobre el MCP o una conexión? Escribe a [email protected]. La política de privacidad explica cómo trata Growwer tus datos.