Skip to content

update mcp docs #89

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
cbrinicombe13 merged 1 commit into from
Sep 8, 2026
Merged

update mcp docs #89

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
135 changes: 83 additions & 52 deletions es/mcp/account-mcp-server/capabilities.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,138 +1,169 @@
---
title: Capacidades
description: Aprende qué puede hacer el servidor MCP de Trophy Account.
og:description: Aprende qué puede hacer el servidor MCP de Trophy Account.
description: Aprende qué puede hacer el servidor MCP de cuenta de Trophy.
og:description: Aprende qué puede hacer el servidor MCP de cuenta de Trophy.
icon: wrench
---

Una vez conectado, el servidor MCP de Account expone herramientas que tu agente puede llamar para inspeccionar y gestionar tu cuenta.
Una vez conectado, el servidor MCP de cuenta expone herramientas que tu agente puede llamar para inspeccionar y gestionar tu cuenta.

La mayoría de los recursos de configuración ofrecen herramientas de **lectura** y **escritura** emparejadas:
La mayoría de los recursos de configuración ofrecen herramientas **de lectura** y **escritura** emparejadas:

- Las herramientas de **lectura** listan y obtienen recursos
- Las herramientas de **escritura** crean o actualizan recursos por lotes para acelerar las operaciones
- Las herramientas **de lectura** listan y obtienen recursos
- Las herramientas **de escritura** crean o actualizan recursos por lotes para acelerar las operaciones

## Referencia de herramientas {#tool-reference}

La lista completa de herramientas disponibles en el servidor MCP de Trophy Account.
La lista completa de herramientas disponibles en el servidor MCP de cuenta de Trophy.

### Herramientas de Métricas {#metrics-tools}
### Herramientas de métricas {#metrics-tools}

Crea y gestiona las [Métricas](/es/features/metrics) que impulsan rachas, logros, puntos y clasificaciones.

| Herramienta | Qué hace |
| --- | --- |
| `read_metrics` | Lista métricas u obtiene una métrica específica por ID |
| `read_metrics` | Lista métricas u obtiene una métrica individual por ID |
| `write_metrics` | Crea o actualiza métricas |

### Herramientas de atributos {#attributes-tools}

Gestiona [atributos de usuario personalizados](/es/features/users#custom-user-attributes) y [atributos de eventos personalizados](/es/features/events#custom-event-attributes) utilizados para segmentación de funcionalidades y personalización.
Gestiona [Atributos de usuario personalizados](/es/features/users#custom-user-attributes) y [Atributos de evento personalizados](/es/features/events#custom-event-attributes) utilizados para segmentación de funcionalidades y personalización.

| Herramienta | Qué hace |
| --- | --- |
| `read_attributes` | Lista atributos u obtiene un atributo específico por ID |
| `read_attributes` | Lista atributos u obtiene un atributo individual por ID |
| `write_attributes` | Crea o actualiza atributos |

### Herramientas de Logros {#achievements-tools}
### Herramientas de logros {#achievements-tools}

Lee [Logros](/es/features/achievements) y analíticas de finalización de tu cuenta.
Configura [Logros](/es/features/achievements) y lee analíticas de finalización para tu cuenta.

| Herramienta | Qué hace |
| --- | --- |
| `read_achievements` | Lista logros con conteos de finalización y rareza; opcionalmente filtra por `user_attributes` |
| `read_achievements` | Lista logros u obtiene un logro individual por ID |
| `write_achievements` | Crea o actualiza logros |
| `read_achievements_analytics` | Lista logros con conteos de finalización y rareza; opcionalmente filtra por `user_attributes` |

### Herramientas de Clasificaciones {#leaderboards-tools}
### Herramientas de clasificaciones {#leaderboards-tools}

Configura [Clasificaciones](/es/features/leaderboards) y lee rankings en vivo.
Configura [Clasificaciones](/es/features/leaderboards) y lee clasificaciones en vivo.

| Herramienta | Qué hace |
| --- | --- |
| `read_leaderboards` | Lista clasificaciones u obtiene una clasificación específica por ID |
| `write_leaderboards` | Crea o actualiza clasificaciones |
| `read_leaderboard_rankings` | Obtiene una clasificación con rankings en vivo por clave (paginación opcional, fecha de ejecución, centrado en usuario y filtros de atributos) |
| `read_leaderboards` | Listar clasificaciones o obtener una clasificación individual por ID |
| `write_leaderboards` | Crear o actualizar clasificaciones |
| `read_leaderboard_rankings` | Obtener una clasificación con rankings en vivo por clave (paginación opcional, fecha de ejecución, centrado en usuario y filtros de atributos) |

### Herramientas de Puntos {#points-tools}

Configura sistemas completos de [Puntos](/es/features/points), incluyendo [Activadores](/es/features/points#points-triggers), [Niveles](/es/features/points#points-levels) y [Potenciadores](/es/features/points#points-boosts), y consulta análisis de distribución.
Configure sistemas completos de [Puntos](/es/features/points), incluyendo [Triggers](/es/features/points#points-triggers), [Niveles](/es/features/points#points-levels) y [Boosts](/es/features/points#points-boosts), y consulte análisis de distribución.

| Herramienta | Qué hace |
| --- | --- |
| `read_points_systems` | Lista sistemas de puntos u obtén uno por ID |
| `write_points_systems` | Crea o actualiza sistemas de puntos (opcionalmente con activadores, niveles y potenciadores anidados) |
| `read_points_triggers` | Lista u obtén activadores para un sistema de puntos |
| `write_points_triggers` | Crea o actualiza activadores para un sistema de puntos |
| `read_points_levels` | Lista u obtén niveles para un sistema de puntos |
| `write_points_levels` | Crea o actualiza niveles para un sistema de puntos |
| `read_points_boosts` | Lista u obtén potenciadores para un sistema de puntos |
| `write_points_boosts` | Crea o actualiza potenciadores para un sistema de puntos |
| `read_points_systems` | Listar sistemas de puntos u obtener uno por ID |
| `write_points_systems` | Crear o actualizar sistemas de puntos (opcionalmente con triggers, niveles y boosts anidados) |
| `read_points_triggers` | Listar u obtener triggers para un sistema de puntos |
| `write_points_triggers` | Crear o actualizar triggers para un sistema de puntos |
| `read_points_levels` | Listar u obtener niveles para un sistema de puntos |
| `write_points_levels` | Crear o actualizar niveles para un sistema de puntos |
| `read_points_boosts` | Listar u obtener boosts para un sistema de puntos |
| `write_points_boosts` | Crear o actualizar boosts para un sistema de puntos |
| `read_points_analytics` | Distribución de puntos y desglose de niveles para un sistema (`summary` o `level_summary`; `user_attributes` opcional en el resumen) |

### Herramientas de Clientes {#tenants-tools}

Administra registros de organizaciones [Multi-Cliente](/es/platform/multi-tenancy) cuando la multi-tenencia esté habilitada en tu cuenta.
Administre registros de organización [Multi-Tenant](/es/platform/multi-tenancy) cuando multi-tenancy esté habilitado en su cuenta.

| Herramienta | Qué hace |
| --- | --- |
| `read_tenants` | Lista clientes u obtén un cliente individual por ID |
| `write_tenants` | Crea o actualiza clientes |
| `read_tenants` | Listar clientes u obtener un cliente individual por ID |
| `write_tenants` | Crear o actualizar clientes |

<Note>
Si la multi-tenencia no está habilitada en tu cuenta, estas herramientas no funcionarán.
Si multi-tenancy no está habilitado en su cuenta, estas herramientas no funcionarán.
</Note>

### Herramientas de Rachas {#streaks-tools}

Consulta y ejecuta acciones operativas de [Rachas](/es/features/streaks) para usuarios, incluyendo la concesión de [Congelaciones de Racha](/es/features/streaks#streak-freezes) o la [restauración de rachas](/es/features/streaks#restoring-a-users-streak).
Consulta y ejecuta acciones operacionales de [Rachas](/es/features/streaks) para usuarios, incluyendo otorgar [Congelaciones de Racha](/es/features/streaks#streak-freezes), crear [Pausas de Racha](/es/features/streaks#streak-pauses), [restaurar rachas](/es/features/streaks#restoring-a-users-streak), y leer o actualizar la configuración de rachas de la organización.

| Herramienta | Qué hace |
| --- | --- |
| `list_user_streaks` | Obtén la longitud de racha (y la marca de tiempo de la última extensión) para hasta 100 usuarios, clasificados de mayor a menor |
| `grant_streak_freezes` | Concede congelaciones de racha a uno o más usuarios |
| `restore_streaks` | Restaura una racha interrumpida a su longitud anterior |
| `list_user_streaks` | Obtener la longitud de racha (y última marca de tiempo de extensión) para hasta 100 usuarios, clasificados por la más larga primero |
| `grant_streak_freezes` | Otorgar congelaciones de racha a uno o más usuarios |
| `restore_streaks` | Restaurar una racha rota a su longitud anterior |
| `create_streak_pauses` | Crear pausas de racha para usuarios durante un rango de fechas (hasta 100 por solicitud) |
| `delete_streak_pauses` | Eliminar pausas de racha por ID (hasta 100 por solicitud) |
| `get_streak_settings` | Obtener la configuración de rachas de la organización (frecuencia, modo de evaluación, métricas, días libres, congelaciones) |
| `update_streak_settings` | Actualizar la configuración de rachas de la organización |

## Ejemplos de prompts {#example-prompts}
### Herramientas de Configuración {#settings-tools}

Usa lenguaje natural: tu agente selecciona la herramienta y los parámetros adecuados:
Lee y actualiza la configuración de la organización, incluyendo [Branding](/es/account/branding), [Experimentación](/es/platform/experimentation) y período de agregación.

| Herramienta | Qué hace |
| --- | --- |
| `get_settings` | Obtener la configuración de branding, experimentación y período de agregación |
| `update_settings` | Actualizar la configuración de branding, experimentación y período de agregación |

## Ejemplos de Prompts {#example-prompts}

Usa lenguaje natural — tu agente selecciona la herramienta y los parámetros correctos:

```text
Crea un sistema de XP llamado 'Kudos' que otorga 10 puntos por cada entrenamiento completado.
```

```text
Programa potenciadores de XP 2X para el sistema 'Kudos' durante los próximos 3 fines de semana (solo para usuarios de pago - el atributo 'plan' es 'pro').
```

```text
Lista todos los logros, tasas de finalización y rareza en mi cuenta de Trophy.
```

```text
Obtén el top 20 de rankings de la clasificación weekly-workouts de esta semana.
```

```text
Create an XP system called 'Kudos' that grants 10 points for each workout completed.
Resume la distribución de puntos de Kudos para usuarios pro.
```

```text
Schedule 2X XP boosts for the 'Kudos' system across the next 3 weekends (only for paying users - 'plan' attribute is 'pro').
¿Cuáles son las longitudes de racha actuales de los usuarios user_123 y user_456?
```

```text
List all achievements, completion rates and rarity in my Trophy account.
Otorga dos congelaciones de racha al usuario user_123.
```

```text
Get the top 20 rankings for leaderboard weekly-workouts this week.
user_123 quiere recuperar su racha, restáurala a su longitud anterior.
```

```text
Summarize the Kudos points distribution for pro users.
Crea una pausa de racha para user_123 desde 2026-09-15 hasta 2026-09-22 mientras está de vacaciones.
```

```text
What are the current streak lengths for users user_123 and user_456?
¿Cuál es nuestra configuración actual de rachas, y configura las congelaciones para empezar con 1 y un máximo de 3?
```

```text
Grant two streak freezes to user user_123.
Crea un logro llamado 'Primer Entrenamiento' que se desbloquea cuando los usuarios completan 1 entrenamiento.
```

```text
user_123 wants their streak back, restore it to its previous length.
Actualiza nuestro color de marca a #0F766E y configura el período de agregación en semanal.
```

## Alcance y seguridad {#scope-and-safety}
## Alcance y Seguridad {#scope-and-safety}

- Las herramientas solo actuarán sobre el [entorno](/es/platform/environments) de Trophy asociado a la clave de API que proporciones en `x-trophy-api-key`.
- Las herramientas de escritura pueden modificar la configuración activa. Usa un [entorno](/es/platform/environments) de pruebas o sandbox al iterar.
- Las herramientas no pueden eliminar recursos.
- Las herramientas solo actuarán en el [entorno](/es/platform/environments) de Trophy vinculado a la clave de API que pases en `x-trophy-api-key`.
- Las herramientas de escritura pueden cambiar la configuración en producción. Prefiere un [entorno](/es/platform/environments) de staging o sandbox al iterar.
- La mayoría de las herramientas no pueden eliminar recursos. La excepción es `delete_streak_pauses`, que elimina pausas de racha por ID.

## Obtener soporte {#get-support}
## Obtener Soporte {#get-support}

¿Quieres ponerte en contacto con el equipo de Trophy? Escríbenos por [correo electrónico](mailto:support@trophy.so). ¡Estamos aquí para ayudarte!
¿Quieres ponerte en contacto con el equipo de Trophy? Contáctanos por [correo electrónico](mailto:support@trophy.so). ¡Estamos aquí para ayudarte!
26 changes: 13 additions & 13 deletions es/mcp/account-mcp-server/introduction.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,43 +1,43 @@
---
title: Introducción
description: Aprende sobre el servidor MCP de cuenta y por qué existe para agentes de IA.
description: Conoce el servidor Account MCP y por qué existe para agentes de IA.
subtitle: Proporciona a los agentes de IA acceso seguro y estructurado a tu
cuenta de Trophy.
---

El servidor MCP de cuenta es un servidor remoto de [Model Context Protocol](https://modelcontextprotocol.io) que permite a los agentes de IA leer y gestionar la configuración de gamificación en tu cuenta de Trophy.
El servidor Account MCP es un servidor remoto de [Model Context Protocol](https://modelcontextprotocol.io) que permite a los agentes de IA leer y gestionar la configuración de gamificación en tu cuenta de Trophy.

En lugar de copiar y pegar clics del panel de control en el chat, puedes pedirle a tu agente que inspeccione Métricas, cree sistemas de Puntos, actualice Clasificaciones, restaure Rachas y más.

```bash Server URL
https://mcp.trophy.so
```

## ¿Por qué el MCP de cuenta? {#why-the-account-mcp}
## ¿Por qué el Account MCP? {#why-the-account-mcp}

Los agentes de programación con IA ya son donde los equipos diseñan y envían trabajo de producto, y Trophy ha simplificado esto al proporcionar infraestructura preconstruida para crear funciones comunes de gamificación. Sin embargo, esto implica en gran medida mirar pantallas y hacer clic en botones.
Los agentes de IA para programación ya son donde los equipos diseñan y entregan trabajo de producto, y Trophy ha simplificado esto proporcionando infraestructura prediseñada para construir funciones comunes de gamificación. Sin embargo, esto implica en gran medida mirar pantallas y hacer clic en botones.

El servidor MCP de cuenta es la **capa de acción**: después de que el agente comprende *qué* construir (a menudo a través del [servidor MCP de documentación](/es/mcp/docs-mcp-server/introduction)), puede descubrir la configuración de cuenta en vivo, realizar cambios específicos y validar resultados sin que un humano toque el panel de control.
El servidor Account MCP es la **capa de acción**: después de que el agente comprende *qué* construir (a menudo a través del [servidor Docs MCP](/es/mcp/docs-mcp-server/introduction)), puede descubrir la configuración activa de la cuenta, realizar cambios específicos y validar resultados sin que un humano toque el panel de control.

Esto abre un nuevo flujo de trabajo para los equipos donde los agentes pueden razonar sobre qué funciones de gamificación construir, entender cómo mapear eso a las funciones de Trophy y configurar una cuenta de Trophy que logre todo esto dentro del chat.
Esto abre un nuevo flujo de trabajo para equipos donde los agentes pueden razonar sobre qué funciones de gamificación construir, entender cómo mapear eso a las funciones de Trophy, y configurar una cuenta de Trophy que logre todo esto dentro del chat.

Los flujos de trabajo típicos incluyen:

- Estructurar Métricas, atributos y sistemas de Puntos mientras se integra Trophy en una nueva aplicación
- Estructurar Métricas, atributos y sistemas de Puntos al integrar Trophy en una nueva aplicación
- Inspeccionar Clasificaciones existentes o configuración de Puntos antes de cambiar código de producción
- Ejecutar tareas operativas como otorgar congelaciones o restaurar Rachas desde el chat
- Ejecutar tareas operativas como conceder congelaciones o restaurar Rachas desde el chat

## Cómo funciona {#how-it-works}
## Cómo Funciona {#how-it-works}

Trophy aloja un endpoint MCP remoto. Lo instalas una vez en tu cliente MCP, te autenticas con una clave API de administrador desde la [página de integraciones](https://app.trophy.so/integration) bajo una configuración `headers` (`x-trophy-api-key`), y el cliente expone herramientas que tu agente puede llamar.
Trophy aloja un endpoint MCP remoto. Lo instalas una vez en tu cliente MCP, te autentícas con una clave API de administrador desde la [página de integraciones](https://app.trophy.so/integration) bajo una configuración `headers` (`x-trophy-api-key`), y el cliente expone herramientas que tu agente puede llamar.

Estas herramientas corresponden a operaciones de cuenta: list/get para descubrimiento, create/update para configuración, y acciones dedicadas para congelaciones de Racha, restauraciones y lectura de analíticas.
Estas herramientas corresponden a operaciones de cuenta: list/get para descubrimiento, create/update para configuración, y acciones dedicadas para congelaciones de rachas, pausas, restauraciones, configuración y lectura de analíticas.

<Note>
El servidor MCP de cuenta está diseñado para flujos de trabajo basados en chat y agentes. Para scripts, trabajos backend o integraciones de producción, utiliza la [API de administración](/es/admin-api/introduction).
El servidor MCP de cuenta está diseñado para flujos de trabajo basados en chat y agentes. Para scripts, trabajos de backend o integraciones de producción, utiliza la [API de administración](/es/admin-api/introduction).
</Note>

## Primeros pasos {#get-started}
## Comenzar {#get-started}

<CardGroup>
<Card title="Instalación" icon="download" href="/es/mcp/account-mcp-server/installation">
Expand Down
Loading
Loading