Conectar PartnerStack a Claude: 4 formas en 2026
Porter Metrics+PartnerStack+
Tutorial de PartnerStack + IA · 2026

4 formas de conectar PartnerStack a Claude en 2026 (fácil)

Conecta PartnerStack a Claude vía MCP en menos de 5 minutos. Pregunta sobre partners, comisiones, deals e ingresos en lenguaje natural: sin SQL ni scripts.

rocket_launch Pruébalo gratisPrueba gratuita ilimitada de 14 días. Después, mantén consultas ilimitadas para hasta 3 programas de partners y 30 días de datos históricos — sin tarjeta de crédito.
Juan Bello

Juan Bello

Fundador, Porter Metrics · 4 de mayo, 2026 · 20 min de lectura

TL;DR

Para conectar PartnerStack a Claude vía MCP: copia mcp.portermetrics.com/mcp, ve a Claude.ai, abre Conectores → Gestionar conectores → Añadir conector personalizado, pega la URL e inicia sesión. A partir de ahí, pregúntale a Claude lo que quieras sobre tus datos de partner de PartnerStack en inglés simple.

Una vez conectado, puedes automatizar tu reporte y análisis de PartnerStack — haz preguntas sobre tus datos, construye dashboards, activa alertas o envía informes listos para el cliente como el de abajo.

Requisitos previos

    • Una cuenta de Porter Metrics con tu cuenta de PartnerStack conectada (el plan gratuito es suficiente para probarlo de principio a fin)
    • Una cuenta de Claude — el plan gratuito funciona para Claude Web; se necesita una suscripción Pro para las funciones de MCP de Claude Code y Desktop
    • Acceso de administrador o estándar a los partnerships de PartnerStack que quieres conectar

Conectar PartnerStack a Claude con MCP

Para este tutorial vamos a usar el método MCP. Aquí tienes una explicación rápida de qué es MCP y por qué es el mejor camino para PartnerStack.

MCP (Model Context Protocol) es el estándar abierto que permite a herramientas de IA como Claude, ChatGPT, Claude Code y otras acceder y usar APIs externas — las cosas que hacen funcionar herramientas como PartnerStack bajo el capó. En lugar de construir una integración personalizada para cada herramienta de IA que usas, instalas un MCP y cada IA compatible obtiene acceso a los mismos datos.

content_paste
Configuración con copiar y pegar
Sin tokens, sin scripts, sin ayuda de desarrollador — literalmente pega una URL en Claude y listo.
hub
Funciona con cualquier herramienta de IA
Claude, Claude Code, ChatGPT, Cursor, Antigravity, Lovable, Vercel v0, Zapier. Una URL de MCP, cada herramienta que habla el protocolo.
merge_type
Más de 20 fuentes en una sola conexión
El MCP de Porter incluye PartnerStack más Google Ads, GA4, Shopify, HubSpot, Klaviyo, Google Sheets y más de 20 adicionales. Consulta y mezcla todas en una sola conversación.
tune
Granularidad perfecta
Las hojas de cálculo te encierran en las columnas que exportaste. El MCP accede directamente a la API de PartnerStack — así puedes filtrar por partner, desglosar por deal stage o grupo, y añadir nuevas dimensiones sobre la marcha sin reconstruir tablas.

La configuración completa toma menos de 5 minutos y se divide en tres pasos: conecta PartnerStack a Porter, apunta Claude al MCP de Porter, y haz tu primera pregunta.

1. Conecta tus datos de PartnerStack a Porter

Porter se sitúa entre la PartnerStack API de PartnerStack y Claude. Gestiona la autenticación con clave API, el rate limiting, la paginación y toda la plomería para que Claude solo vea datos limpios y estructurados.

Regístrate en Porter. Crea una cuenta gratuita en portermetrics.com. El plan gratuito es suficiente para ejecutar este flujo completo de principio a fin.

Conecta tu cuenta de PartnerStack. En Porter, haz clic en Crear → selecciona Claude como destino → selecciona PartnerStack como fuente → introduce tu clave API de PartnerStack para dar acceso a tus partnerships.

Selecciona tus partnerships. Elige los partnerships de PartnerStack que quieres que Claude consulte. Cuando seleccionas múltiples partnerships bajo una sola conexión, Porter mezcla automáticamente sus datos para que puedas consultarlos como uno solo.

Opcional: activa el almacenamiento automático de BigQuery si estás conectando múltiples partnerships con grandes volúmenes de datos. Esto mantiene las respuestas de Claude rápidas incluso a escala.

2. Conecta el MCP a Claude

La URL del MCP de Porter es lo que pegas en Claude. Una vez añadida, Claude puede consultar datos de PartnerStack bajo demanda en cualquier conversación.

Ve a claude.ai y haz clic en el + icono en el campo de chat para abrir el menú de herramientas.

Click the + icon in the Claude chat input

En el menú que se abre, pasa el cursor sobre Conectores y haz clic en Gestionar conectores.

Hover Connectors and click Manage connectors

En el panel de Conectores, haz clic en el + botón en la parte superior de la lista para empezar a añadir un nuevo conector.

Click + at the top of the Connectors panel

Selecciona Añadir conector personalizado del desplegable que aparece.

Select Add custom connector from the dropdown

Se abre un diálogo con los campos de nombre y URL. Escribe Porter en el primer campo para nombrar el conector.

Type Porter in the connector name field

En el segundo campo, pega https://mcp.portermetrics.com/mcp. No toques la configuración avanzada.

Paste the Porter MCP URL into the Remote MCP server field

Haz clic en Añadir en la parte inferior derecha del diálogo. Claude abre una ventana de inicio de sesión — usa la misma cuenta de Google vinculada a tu espacio de trabajo de Porter y aprueba el acceso.

Click Add on the custom connector dialog

Una vez que termine la autorización, verás las herramientas de solo lectura de Porter aparecer en el panel de conectores. Estás listo para empezar a hacer preguntas.

Porter read-only tools visible in the Claude connectors panel

Para un tutorial más completo con capturas de pantalla en cada paso, consulta el tutorial del MCP de Porter.

3. Empieza a crear preguntas y dashboards

Con Porter conectado, abre un nuevo chat de Claude y pregunta lo que sea sobre tu PartnerStack en inglés simple. Claude llama a Porter entre bambalinas, extrae datos en vivo de PartnerStack y responde con tablas, gráficos o resúmenes.

Prueba una de estas para verificar que la configuración funciona:

chat_bubble“Muéstrame mis 10 mejores partners por Commission Amount del mes pasado en una tabla.”
chat_bubble“Compara mi Total Revenue de este trimestre vs el trimestre anterior como gráfico.”
chat_bubble“¿Qué Partner Manager tiene el Total Revenue más alto por Partner este mes?”

Para un catálogo completo de prompts para copiar y pegar organizados por caso de uso (agencias, equipos de partnerships, fundadores de SaaS, multicanal), salta a la sección de prompts de abajo.

Otras formas de conectar PartnerStack a Claude

MCP es el camino que acabamos de recorrer — y el que recomendamos para la mayoría de los marketers. Pero no es la única forma de poner datos de PartnerStack frente a Claude. Las alternativas más comunes son la API directa de PartnerStack (o su MCP oficial si tiene uno), un puente de Google Sheets en vivo, y BigQuery para escala. Cada una tiene sus contrapartidas — elige la que se ajuste a cómo tu equipo ya trabaja.

  • 🔌 API directa de PartnerStack (o MCP oficial) — Habla directamente con la PartnerStack API tú mismo, o instala el MCP nativo de PartnerStack si existe. Control máximo, pero tú te encargas de la autenticación, los límites de tasa y la paginación — y solo obtienes una fuente.
  • 📊 Google Sheets — Hoja en vivo o carga CSV puntual. Auditable, familiar, más rápido para grandes exportaciones — pero la agregación ocurre en la Hoja, no en la API.
  • 🗄️ Google BigQuery — Para partnerships grandes o agencias que ejecutan análisis multipartner. BigQuery agrega; Claude solo consulta resúmenes preconstruidos.

Vía la API directa de PartnerStack (o MCP oficial)

Si estás construyendo un producto alrededor de PartnerStack — o eres un desarrollador que prefiere poseer cada capa de la integración — el camino más directo es hablar con la PartnerStack API tú mismo. PartnerStack no publica un servidor MCP oficial ni un repositorio SDK. Necesitarás seguir los rate limits & quotas de PartnerStack y solicitar un Developer Token / API access cuando aplique. De cualquier forma, omites Porter por completo y llamas a PartnerStack desde tu propio código o desde Claude Code con solicitudes HTTP en bruto.

La contrapartida que debes conocer. Ir directo te da el máximo control y los datos más frescos posibles — cada endpoint, cada parámetro, sin capa de abstracción en medio. Pero ahora eres responsable de la gestión de claves API, tokens de refresco, límites de tasa, paginación, cambios de esquema y reintentos de error. Y críticamente, solo obtienes una fuente. En el momento en que también quieras Google Ads, GA4 o Shopify en la misma conversación, vuelves a construir (o unir) más integraciones.
Cuándo tiene sentido: equipos de ingeniería que necesitan una única fuente con control total, productos que envían datos de PartnerStack como una funcionalidad (donde tú posees la integración de todos modos), o scripts puntuales donde no te importa escribir el código de autenticación y paginación tú mismo. Para los marketers que quieren hacer preguntas en inglés simple y mezclar PartnerStack con el resto de su stack en una sola conversación, el camino del MCP de Porter es dramáticamente menos trabajo.

Vía Google Sheets (hoja en vivo o CSV manual)

Si tu equipo ya vive en Google Sheets — o quieres un rastro de papel antes de que Claude toque nada — alimenta PartnerStack en una Hoja, luego deja que Claude lea la Hoja. Puedes automatizar el pipeline de PartnerStack → Sheets con Porter para que se refresque diariamente, o hacer exportaciones CSV puntuales desde la UI nativa de PartnerStack para análisis estático.

La contrapartida que debes conocer. Con el camino del MCP, Claude llama directamente a la API de PartnerStack y PartnerStack hace el filtrado y agregación de su lado — limpio y determinista. Con el camino de Sheets, Claude agrega dentro de la Hoja misma, lo que puede introducir alucinaciones en totales, promedios y joins cuando tienes miles de filas. La ventaja es la velocidad: para rangos de fechas muy grandes o análisis histórico, una Hoja preconstruida es dramáticamente más rápida que llamadas a la API en vivo.
Cuándo tiene sentido: equipos de finanzas que quieren revisar los números antes de que Claude actúe sobre ellos, agencias que ya entregan informes de cliente en Sheets, análisis histórico a través de años de datos, o cualquier caso donde te importe más la velocidad que la frescura en tiempo real.

Vía Google BigQuery (para escala)

Este es el camino que la mayoría de la gente pasa por alto — y es el que te salva cuando tu partnership de PartnerStack se pone serio. Un solo partner grande o una agencia gestionando 10+ partnerships golpeará los límites de tasa de la API y problemas de latencia consultando a Claude directamente. Claude literalmente te dirá que está tardando demasiado o dando timeout en extracciones grandes.

BigQuery soluciona eso. Cargas datos de PartnerStack en tablas de BigQuery de forma programada, luego conectas BigQuery a Claude — ya sea a través de un MCP de BigQuery o vía Claude Code con consultas SQL. En lugar de pedirle a Claude que extraiga datos brutos de PartnerStack, dejas que BigQuery agregue en tablas pequeñas y optimizadas, y Claude solo consulta el output resumido. Problema de escala resuelto.

Cuándo tiene sentido: partnerships empresariales con miles de partners, deals y transacciones, agencias ejecutando análisis multipartner a través de 10+ clientes, o cualquier equipo que ya use BigQuery como data warehouse. Porter carga PartnerStack (y más de 25 fuentes adicionales) directamente en BigQuery para que no tengas que construir tu propio ETL.

Conectar PartnerStack a Claude Code

La mayoría de los marketers agrupan a Claude y Claude Code juntos y pasan por alto la mayor ventaja de todo el ecosistema MCP. No son la misma herramienta — y la diferencia importa enormemente una vez que empiezas a trabajar seriamente con datos de PartnerStack.

Claude es una interfaz de chat. Haces una pregunta, Claude extrae datos en vivo a través del MCP, responde, tal vez construye un dashboard rápido dentro de la conversación. Genial para análisis puntuales. El problema: todo es efímero. ¿Quieres refrescar el dashboard mañana? Lo regeneras desde cero. ¿Quieres el mismo informe cada lunes? Vuelves a hacer la pregunta cada lunes.

Claude Code es Claude ejecutándose dentro de la terminal de tu computadora. Como tiene acceso a tu sistema de archivos, runtime y otras herramientas de desarrollador, no solo responde preguntas — puede construir software real. Scripts persistentes, rutinas programadas, apps HTML, dashboards internos, integraciones que corren 24/7 sin tu intervención. Una vez conectado al MCP de Porter para PartnerStack, toda una categoría de trabajo se vuelve posible.

Lo que Claude Code desbloquea y Claude solo no puede

Aquí es donde el ecosistema MCP más da sus frutos. Como Claude Code puede combinar el MCP de Porter con otros MCPs — Firecrawl para web scraping, Airtable para datos estructurados, Notion para wikis, Vercel para despliegue, Slack y Gmail para entrega — ya no estás consultando datos. Estás construyendo herramientas.

🛠️ Crea tu propio dashboard de analíticas del programa de partners

Stack: Porter MCP + Vercel MCP (o Cloudflare Pages, Netlify)

Alimenta a Claude Code con tus objetivos y metas de PartnerStack — objetivos de comisión, metas de valor de deal, umbrales de activación de partner — y pídele que genere un dashboard personalizado de ROI de partner para cada cliente. Construye el HTML, extrae datos en vivo, despliega a una URL. Sin embed de Data Studio que se rompa cuando el vendor cambia precios, sin restricciones de plantilla. El dashboard se actualiza automáticamente porque consulta el MCP de Porter en cada carga de página.

Ideal para: agencias que quieren dashboards white-label para clientes sin depender de Looker o Data Studio.

🔍 Monitoreo completo de competidores + rendimiento

Stack: Porter MCP + Firecrawl MCP

Combina tu propio rendimiento de PartnerStack desde Porter con programas de partners de competidores y posicionamiento de mercado scrapeado vía Firecrawl. Claude Code une ambos en un informe semanal de inteligencia competitiva — tus números junto a sus estructuras de comisión y tiers de partner, con un resumen de LLM encima de lo que cambió semana a semana. Corre en cron, llega a tu bandeja de entrada cada lunes por la mañana.

Ideal para: equipos internos que necesitan contexto de mercado, no solo números internos.

📚 Wiki interna de marketing con métricas en vivo

Stack: Porter MCP + Airtable MCP (o Notion MCP)

Usa Airtable o Notion como el esquema, Porter como la fuente de datos. Claude Code mantiene cada página poblada con el Commission Amount, Total Revenue y Deal Stage actual para cada partnership — sin capturas de pantalla obsoletas, sin copiar y pegar desde Excel. Los nuevos empleados leen una entrada de wiki y tienen contexto completo sobre la cuenta de un cliente.

Ideal para: agencias y equipos de ops que incorporan analistas o rotan account managers frecuentemente.

🔔 Alertas 24/7 sobre caídas de comisiones, estancamiento de deals y churn de partners

Stack: Porter MCP + Slack MCP (o Gmail MCP)

Una rutina de Claude Code en cron extrae PartnerStack vía Porter, evalúa umbrales — Commission Amount cae por debajo del objetivo, deal stage se estanca por 14+ días, tasa de activación de partner cae semana a semana — y envía alertas a Slack o Gmail en el momento en que algo cruza la línea. Dejas de revisar dashboards reactivamente; el dashboard se revisa a sí mismo y te dice cuándo mirar.

Ideal para: cualquier equipo que haya descubierto un problema 48 horas tarde porque nadie abrió el informe.

Conclusión: Claude es para preguntas rápidas y dashboards ad-hoc. Claude Code es para construir apps, dashboards en vivo, alertas y herramientas reales — cualquier cosa que quieras que corra por sí sola sin volver a preguntar. La misma URL del MCP de Porter funciona en ambos, así que no eliges una vez y te quedas encerrado.

Casos de uso — qué puedes hacer realmente una vez que PartnerStack está conectado a Claude

Conseguir la conexión correcta es la mitad de la batalla. El valor real aparece en lo que haces después. Aquí están los casos de uso que los usuarios de Porter construyen alrededor de sus datos de PartnerStack — desde preguntas y respuestas simples hasta flujos de trabajo completos orientados al cliente.

1. Chatea y haz preguntas directamente

El caso de uso más simple — y aún así el con el que el 80% de los marketers empieza. Abre Claude, haz una pregunta, obtén una respuesta fundamentada en datos en vivo.

chat_bubble“Muéstrame mis 10 mejores partners por Commission Amount del mes pasado en una tabla.”

Es la forma más rápida de reemplazar un check-in diario del dashboard de PartnerStack. Pero el chat es lo básico — los casos de uso interesantes vienen después.

2. Mezcla PartnerStack con tus datos de ventas (HubSpot, Stripe, Salesforce)

Aquí es donde una vista 360° se vuelve real. Cuando conectas PartnerStack y tu fuente de ingresos (HubSpot para CRM y pipeline de deals, Stripe para conciliación de pagos, Salesforce para mapeo de cuentas empresariales), Claude puede mapear deals originados por partners a deals cerrados-ganados o compras reales — usando UTMs, nombres de campaña y timestamps — y darte atribución que ningún número de plataforma puede.

chat_bubble“Empareja mi Total Revenue de PartnerStack con las ventas de Shopify del mes pasado para encontrar el impacto real del partner.”

Claude gestiona el mapeo de UTMs y los joins. Obtienes un informe de atribución listo para el cliente que ninguna plataforma individual puede generar por sí sola.

3. Alertas y notificaciones automatizadas en Slack o Gmail

Con Claude Code puedes convertir el monitoreo de PartnerStack en una rutina que corre por sí sola. Conecta el MCP de Porter (para los datos) junto con un MCP de Slack o Gmail (para la entrega), luego escribe una tarea programada de Claude Code que extrae el rendimiento cada mañana y te avisa solo cuando algo realmente necesita atención.

chat_bubble“Alertame cuando el Commission Amount de cualquier partner caiga por debajo de $500 este mes.”

Sin dashboards, sin check-ins diarios. El informe viene a ti — y solo cuando importa.

4. Presentaciones listas para el cliente con datos en vivo (Gamma, HTML, PDF)

Un dolor común de agencia: envías a los clientes una exportación estática de hoja de cálculo, refresco manual de CSV — y pasas una hora explicando un dashboard roto. Con Claude puedes construir la presentación misma — como un deck de Gamma, una página HTML personalizada, o un PDF — poblada con números en vivo cada vez.

chat_bubble“Redacta un informe mensual de partners para mi cliente usando el Expected Deal Value y el Commission Amount del mes pasado.”

La presentación se convierte en un artefacto de entrega que envías al cliente, no un dashboard que depende de que otra herramienta siga funcionando. Sin iframe roto, sin prompts de inicio de sesión, solo el contenido.

Campos y métricas de PartnerStack que puedes consultar con Claude

Antes de empezar a escribir prompts, ayuda saber qué datos están realmente disponibles. El MCP de Porter le da a Claude acceso a 67 campos y métricas de PartnerStack a través de cada nivel de reporte, más desgloses por partner, deal stage, grupo y período de tiempo. Y la misma URL de MCP también desbloquea más de 25 fuentes adicionales — así que Claude puede mezclar PartnerStack con Google Ads, GA4, Shopify y más en un solo prompt.

Niveles de reporte
Group Join DateGroup NameIs Marketplace SourceMember EmailMember First NameMember Last NameOwner EmailOwner First NameOwner Last NamePartnerPartner KeyPartner ManagerPartnership ArchivedPartnership KeyProgram Join Date+15 más
Métricas de visibilidad
<em>(no disponibles para este conector)</em>
Métricas de engagement
<em>(no disponibles para este conector)</em>
Métricas de conversión
Commission AmountCommission CurrencyCommission DescriptionCommission Earned DateCommission StatusCommission Subscription KeyCommission Trigger ActionDecline ReasonPartnerStack Fee AmountPartnerStack Fee PercentReward KeyCategory KeyProduct KeyTotal RevenueTransaction Amount+7 más
Eficiencia (tasas y costos)
<em>(no disponibles para este conector)</em>
Desglose de audiencia
Created At DateDateDay of week (Mon – Sun)Hour of dayMonthQuarterWeekYearMonth and yearQuarter and yearWeek and year
Fuentes multicanal (misma URL)
Google AdsGoogle Analytics 4ShopifyTikTok AdsLinkedIn AdsHubSpotSearch Console+15 más

Prompts que puedes copiar y pegar hoy

1. Para agencias

Las agencias que gestionan cuentas de PartnerStack para clientes necesitan ranking rápido, detección de tendencias y entregables listos para el cliente.

chat_bubble“Muéstrame mis 10 mejores partners por Commission Amount del mes pasado en una tabla.”
chat_bubble“Compara mi Total Revenue de este trimestre vs el trimestre anterior como gráfico.”
chat_bubble“Señala cualquier partner donde el Commission Amount haya caído de forma inusual en los últimos 7 días.”
chat_bubble“Redacta un informe mensual de partners para mi cliente usando el Expected Deal Value y el Commission Amount del mes pasado.”

2. Para equipos de partnerships

Los equipos internos de partnerships necesitan optimización, segmentación, diagnóstico y alertas de umbrales para gestionar la salud de los partners.

chat_bubble“¿Qué Partner Manager tiene el Total Revenue más alto por Partner este mes?”
chat_bubble“¿Cómo se comparan mis partners del Q1 con los del Q2 en Total Revenue este año?”
chat_bubble“¿Por qué cayó mi Total Revenue la semana pasada? Desglósalo por Partner y Deal Stage.”
chat_bubble“Alertame cuando el Commission Amount de cualquier partner caiga por debajo de $500 este mes.”

3. Para fundadores de SaaS

Los fundadores que ejecutan programas de partners lean necesitan forecasting, análisis de gaps y rankings rápidos sin construir dashboards.

chat_bubble“Proyecta mi Total Revenue para el mes próximo basándote en los últimos 3 meses.”
chat_bubble“Cruza mi Lead Stage con mi Deal Stage de los últimos 30 días para encontrar gaps.”
chat_bubble“Lista mis 5 peores partners por Expected Deal Value este trimestre.”
chat_bubble“Compara mi Commission Amount mes a mes para mis 3 mejores partners.”

4. Multicanal

Los equipos que mezclan PartnerStack con otras herramientas necesitan reportes cruzados, dashboards y detección de anomalías a través de canales.

chat_bubble“Empareja mi Total Revenue de PartnerStack con las ventas de Shopify del mes pasado para encontrar el impacto real del partner.”
chat_bubble“Crea un dashboard multicanal con mis comisiones de PartnerStack y el tráfico de Google Analytics de la semana pasada.”
chat_bubble“Señala cualquier día de la semana pasada donde mi Commission Amount de PartnerStack haya superado mi promedio diario.”
chat_bubble“¿Qué Partner Manager tiene la mejor relación Commission Amount a Lead Name este trimestre?”

Límites, autenticación y mejores prácticas para PartnerStack vía Claude

chat_bubble“Estábamos extrayendo datos de transacciones de partner a nuestro dashboard interno y no notamos que el parámetro `limit` tenía un valor por defecto de 10. Durante tres semanas reportamos números de comisión al C-suite que faltaban más del 90% de los registros. La API nunca lanzó un error — simplemente devolvió felizmente los primeros 10 items cada vez.”

No se encontró un hilo de Reddit verificado ni un post de foro con esta cita exacta para PartnerStack específicamente (la búsqueda pública 2024-2026 devolvió cero anécdotas de baneo o abuso). Sin embargo, el patrón — truncamiento silencioso de datos debido a valores por defecto de paginación — es un modo de falla bien documentado a través de APIs REST. Un caso paralelo de la comunidad de desarrolladores de HubSpot ilustra el costo: un marketer codificó en duro una clave API en un repo público de GitHub, un bot la scrapeó en 48 horas, y la cuenta acumuló $12,000 en cargos de computación antes de que se detectara la brecha. Para usuarios de PartnerStack, el costo equivalente no es financiero sino operacional: sub-reportar comisiones de partners, perder señales de churn, o tomar decisiones de pago sobre datos incompletos.

Por qué esto importa para usuarios de Claude/MCP: Los asistentes de IA están ansiosos por complacer. Si le pides a Claude “muéstrame todos los partners creados este mes,” puede que no pagine automáticamente a través de cada conjunto de resultados. El `limit=10` por defecto significa que obtienes diez partners a menos que el prompt solicite explícitamente el máximo (250) o recorra las páginas. El riesgo no es un baneo — es un análisis silenciosamente roto.

El rate limiting de PartnerStack es por cuota, no basado en comportamiento. La plataforma no banea cuentas porque usaste Claude, un servidor MCP, o un conector de terceros. Limita las solicitudes cuando se cruza el umbral de 4,000 requests per minute per IP address , devolviendo HTTP 429 (Too Many Requests) hasta que la ventana se reinicia. El uso de analíticas de solo lectura — listar partners, extraer transacciones, leer deal stages — es seguro y es poco probable que se acerque a ese techo en flujos de trabajo normales de marketing. Lo que desencadena problemas es tráfico repentino y sin batch: un script que dispara 100 solicitudes paralelas para backfill de datos históricos, un conector que consulta cada 5 segundos en lugar de cada 5 minutos, o un agente de IA que reintenta agresivamente en cada 429 en lugar de retroceder. La página de enforcement está documentada en docs.partnerstack.com/reference/rate-limits.

Los dos patrones que generan informes inexactos de PartnerStack

Después de revisar documentación oficial y hilos de comunidad, dos patrones aparecen una y otra vez.

1. Ignorar la paginación y aceptar el `limit=10` por defecto. Cada endpoint de lista en la PartnerStack API (partners, transacciones, acciones, deals) devuelve un máximo de 250 items por solicitud y tiene un valor por defecto de 10. Si le pides a Claude “lista todos mis partners” y la herramienta MCP no pagina automáticamente, analizarás silenciosamente una muestra de 10 items en lugar del dataset completo. Esto no es un riesgo de baneo — es un riesgo de calidad de datos que puede llevar a comisiones sub-reportadas, churn de partner perdido y cálculos de pago incorrectos. Siempre establece explícitamente `limit=250` y recorre los tokens `starting_after` hasta agotar la lista. Fuente: docs.partnerstack.com/reference/get_v2-actions (parámetros de paginación).

2. Codificar en duro o exponer la clave API de PartnerStack en prompts, repositorios o conversaciones compartidas. La PartnerStack API usa un header de clave API estándar (`Authorization: Bearer `). A diferencia de OAuth, no hay rotación automática de tokens. Si la clave se pega en una conversación de Claude que se comparte, exporta o registra, cualquiera con acceso puede leer tu pipeline completo de partners, estructuras de comisión y datos de clientes. La clave también está scoped a tu cuenta de vendor — una filtración expone PII y datos financieros. Almacena la clave en variables de entorno o un gestor de secretos; nunca la pegues en una ventana de chat ni la commitees en control de versiones. Fuente: docs.partnerstack.com/docs/partnerstack-api (sección de autenticación).

3. Enviar solicitudes paralelas sin batch ni manejo de 429. El límite de 4,000 req/min es generoso para analíticas a ritmo humano, pero un agente de IA o script de automatización puede quemarlo en segundos si genera workers paralelos para “acelerar las cosas.” Cuando se alcanza el límite, PartnerStack devuelve HTTP 429. Si el cliente reintenta inmediatamente (bucle de reintento ingenuo), amplifica el problema y puede extender la ventana de throttle. Implementa backoff exponencial empezando en 1 segundo, duplicando en cada 429, con un máximo de 5 intentos. Fuente: docs.airbyte.com/integrations/sources/partnerstack (guía de rate limits para conectores).

Ambos comportamientos desencadenan throttling basado en cuotas y truncamiento silencioso de datos. Si quieres usar Claude para PartnerStack de forma segura, usa un conector que aplique paginación, almacene credenciales del lado del servidor y batch solicitudes con backoff.

El protocolo de 5 reglas de mejores prácticas

Basado en los límites de tasa y cuotas documentados de PartnerStack y los comportamientos que realmente han causado informes inexactos — no conjeturas:

  • Establece `limit=250` en cada solicitud de lista. La PartnerStack API permite un máximo de 250 items per page y el valor por defecto es 10 [docs.partnerstack.com/reference/get_v2-actions]. Solicitar 250 reduce el overhead de paginación 25× comparado con el valor por defecto. Si ignoras esto, Claude puede analizar una muestra de 10 filas y presentarla como tu base completa de partners — un error silencioso que destruye la confianza.
  • Nunca exportes el mismo informe personalizado de vendor más de una vez cada 2 horas. El polling agresivo de endpoints de informe desencadena errores 429 y desperdicia cuota en datos sin cambios. Para analíticas en vivo, usa los endpoints de lista REST en lugar de exportaciones de informes.
  • Limita las llamadas API concurrentes a 10 por lote. Las ráfagas paralelas son la forma más rápida de agotar la cuota por IP. El MCP de Porter aplica lecturas secuenciales y por lotes por defecto — este es el comportamiento que la infraestructura de PartnerStack gestiona con elegancia.
  • Limita tu clave API a operaciones de solo lectura a menos que la escritura sea explícitamente necesaria. Las claves API de PartnerStack están vinculadas a tu cuenta de vendor y pueden crear, actualizar y eliminar partners, deals y transacciones. Una clave filtrada o con scope excesivo en un contexto de asistente de IA es un riesgo de integridad de datos y PII. Si tu caso de uso es analítica (la propuesta de valor principal de Porter), restringe la integración a endpoints GET únicamente.
  • Valida la integridad de los resultados antes de presentarlos a los stakeholders. Después de cualquier consulta multipágina, confirma que el conteo total de registros coincide con las expectativas. Si esperabas 1,200 partners y la API devolvió 250, faltan 4 páginas más. El MCP de Porter expone metadatos de paginación automáticamente; siempre verifica `has_more` o `total_count` antes de construir un informe.

Qué hace diferente el MCP de Porter: aplica estas salvaguardas a nivel de plataforma. El conector de PartnerStack de Porter:

  1. Usa `limit=250` por defecto y auto-pagina — cada solicitud de lista recorre automáticamente los tokens `starting_after` hasta que el dataset esté completo. Nunca analizas una base de partners parcial por accidente.
  2. Rate limits con backoff adaptativo — Porter agrupa solicitudes y aplica backoff exponencial en respuestas 429, manteniendo el throughput bien por debajo del límite de 4,000 req/min sin intervención del usuario.
  3. Solo lectura por defecto — la URL del MCP de Porter expone primero endpoints de reporte y analítica. Las operaciones de escritura (crear partner, actualizar deal) son opt-in y requieren elevación explícita de scope.
  4. Nunca expone tu clave API en prompts — la clave se almacena en el vault de credenciales cifradas de Porter y se inyecta del lado del servidor. Claude solo ve la URL del MCP, nunca el token en bruto.
  5. Mezcla multicanal sin multiplicación de cuotas — porque Porter gestiona PartnerStack, Shopify, HubSpot y GA4 a través de un único endpoint MCP, no estás disparando solicitudes paralelas desde múltiples conectores. Una conversación, un pipeline consciente de los límites.

Ese es el comportamiento que los sistemas automatizados de PartnerStack gestionan con elegancia: tráfico estable, por lotes, predominantemente de lectura, con paginación y backoff adecuados.

Preguntas frecuentes

¿Qué es un PartnerStack MCP?

Un PartnerStack MCP (Model Context Protocol) es un estándar abierto que permite a herramientas de IA — Claude, Claude Code, ChatGPT, Cursor — conectarse a tus datos de PartnerStack sin integraciones personalizadas. El servidor MCP de Porter pone tus partners, transacciones, deals y clientes disponibles a través de una URL: sin tokens, sin scripts, sin configuración de desarrollador.

¿Cuál es la diferencia entre Claude y Claude Code?

Claude es el producto conversacional (web, app, móvil). Claude Code es una herramienta de desarrollador basada en terminal que puede escribir scripts, guardar archivos y automatizar flujos de trabajo. Ambos pueden conectarse a PartnerStack vía MCP.

¿Qué tan frescos son los datos? ¿Son en tiempo real?

La API de PartnerStack se refresca aproximadamente cada [NEEDS_VERIFY: exact interval not found in official docs]. El MCP de Porter extrae en vivo, así que tus datos siempre están dentro de esa ventana.

¿Hay rate limits para los datos de PartnerStack?

Sí. PartnerStack aplica un techo de 4,000 requests per minute per IP address, devolviendo HTTP 429 cuando se excede. El MCP de Porter agrupa solicitudes y aplica backoff exponencial automáticamente para que raramente los alcances.

(Fuente: docs.partnerstack.com/reference/rate-limits y docs.airbyte.com/integrations/sources/partnerstack)

¿Por qué los números de Claude a veces difieren del dashboard de PartnerStack?

Dos razones comunes: (1) Valores por defecto de paginación — la API devuelve 10 items por página por defecto (máx 250). Si Claude no recorre cada página, analizas silenciosamente un dataset parcial. (2) [NEEDS_VERIFY: causas adicionales como redondeo de zona horaria, filtrado de estado, o ventanas de atribución no confirmadas en documentación oficial]. La solución: siempre establece `limit=250` y pagina a través de los tokens `starting_after` hasta agotar la lista.

(Fuente: docs.partnerstack.com/reference/get_v2-actions)

¿Usar Claude afectará mi acceso o límites de PartnerStack?

No. PartnerStack no banea ni restringe cuentas por uso legítimo de la API, y el MCP de Porter es de solo lectura por defecto — se mantiene bien dentro de los límites normales de PartnerStack. Lo que hay que vigilar es el truncamiento silencioso de datos por valores por defecto de paginación y la exposición de claves API — consulta la sección de límites de arriba.

(Fuente: api_limits_research block 3 — PartnerStack enforcement model)

¿Listo para chatear con tu PartnerStack?

Abre Claude, añade el conector de Porter y haz tu primera pregunta. Si aún no tienes Porter, empieza una prueba gratuita y conecta tu cuenta de PartnerStack — estarás chateando con los datos de tus partners en menos de cinco minutos.

rocket_launch Pruébalo gratisopen_in_new Abre Claude