From 0bb3273db2400c86d05f1ce56471890d1bd8174e Mon Sep 17 00:00:00 2001 From: Charlie Hopkins-Brinicombe Date: Wed, 9 Sep 2026 16:04:19 +0100 Subject: [PATCH 1/3] Update docs to use oauth for account mcp server --- getting-started/quickstart.mdx | 2 +- mcp/account-mcp-server/capabilities.mdx | 4 +- mcp/account-mcp-server/installation.mdx | 106 +++++++++--------------- mcp/account-mcp-server/introduction.mdx | 4 +- mcp/best-practice.mdx | 2 +- 5 files changed, 45 insertions(+), 73 deletions(-) diff --git a/getting-started/quickstart.mdx b/getting-started/quickstart.mdx index 9b28109..e36ca7b 100644 --- a/getting-started/quickstart.mdx +++ b/getting-started/quickstart.mdx @@ -28,7 +28,7 @@ Here you'll integrate your application with Trophy and start building your first For the best AI setup experience, connect Trophy through MCP: - Docs MCP server URL: `https://docs.trophy.so/mcp` (live documentation context) - - Account MCP server URL: `https://mcp.trophy.so` (account actions — see [MCP](/mcp/overview); requires `x-trophy-api-key`) + - Account MCP server URL: `https://mcp.trophy.so/mcp` (account actions — see [MCP](/mcp/overview); OAuth sign-in) Use the [Docs MCP](/mcp/docs-mcp-server/introduction) as on-demand docs context and the [Account MCP](/mcp/account-mcp-server/introduction) for account changes. Use both for [best practice](/mcp/best-practice). diff --git a/mcp/account-mcp-server/capabilities.mdx b/mcp/account-mcp-server/capabilities.mdx index 2234e7c..fc2eefe 100644 --- a/mcp/account-mcp-server/capabilities.mdx +++ b/mcp/account-mcp-server/capabilities.mdx @@ -168,7 +168,9 @@ Update our brand color to #0F766E and set the aggregation period to weekly. ## Scope and Safety {#scope-and-safety} -- Tools will only act on the Trophy [environment](/platform/environments) tied to the API key you pass in `x-trophy-api-key`. +- Access is scoped to the Trophy organization you authorize during OAuth. +- Tools act on a specific [environment](/platform/environments). If the account has only one, tool calls default to it (normally `production`). If there are multiple, pass the `environment` key you want—or use `read_environments` to list them and choose. +- When [multi-tenancy](/platform/multi-tenancy) is enabled, tools can also be scoped to a [tenant](/platform/multi-tenancy). If there is only one active tenant, tool calls can default to it. If there are multiple, pass the `tenant` id you want, or use `read_tenants` to list them and choose. - Write tools can change live configuration. Prefer a staging or sandbox [environment](/platform/environments) when iterating. - Most tools cannot delete resources. The exception is `delete_streak_pauses`, which removes streak pauses by ID. diff --git a/mcp/account-mcp-server/installation.mdx b/mcp/account-mcp-server/installation.mdx index c9e67ce..a7d344d 100644 --- a/mcp/account-mcp-server/installation.mdx +++ b/mcp/account-mcp-server/installation.mdx @@ -1,6 +1,6 @@ --- title: Installation -description: Install the Account MCP Server in Claude Code, Cursor, VS Code, and other MCP clients. +description: Install the Account MCP Server in Claude, Claude Code, Cursor, ChatGPT, VS Code, and other MCP clients. subtitle: Connect the remote Account MCP Server to your coding agent. icon: download --- @@ -9,45 +9,36 @@ icon: download You need a [Trophy account](https://app.trophy.so/sign-up) to use the Trophy Account MCP Server. -The Trophy Account MCP Server is a remote HTTP MCP server. You point your client at the URL below using your [Admin API key](/admin-api/authentication) and your agent can start using the tools. +The Trophy Account MCP Server is a remote HTTP MCP server. Point your client at the URL below, complete OAuth sign-in with your Trophy account when prompted, and your agent can start using the tools. ```bash Server URL -https://mcp.trophy.so +https://mcp.trophy.so/mcp ``` +No API keys are required. Authentication uses OAuth: your MCP client opens a browser so you can sign in to Trophy and authorize access for the organization you select. + ## Install in Your Client {#install-in-your-client} Name this server clearly (for example `Trophy Account`) so it does not collide with the [Docs MCP Server](/mcp/docs-mcp-server/installation). - - Replace `YOUR_ADMIN_API_KEY` with an API key from the [integrations page](https://app.trophy.so/integration) of the Trophy dashboard. - - + + 1. Open [Claude Connectors](https://claude.ai/new#settings/customize-connectors). + 2. Select **Add > Add custom connector**. + 3. Add: + - Name: `Trophy Account` + - URL: `https://mcp.trophy.so/mcp` + 4. Complete the OAuth login when prompted and select your Trophy organization. + 5. In chat, use the plus button to enable the Trophy Account connecto or type 'Using the Trophy Account MCP Server...'. + - Add the remote server with a `headers` entry for the API key: + Add the remote server: ```bash - claude mcp add-json "Trophy Account" '{ - "type": "http", - "url": "https://mcp.trophy.so", - "headers": { - "x-trophy-api-key": "YOUR_ADMIN_API_KEY" - } - }' + claude mcp add --transport http "Trophy Account" https://mcp.trophy.so/mcp ``` - To pull the key from the environment instead of inlining it: - - ```bash - claude mcp add-json "Trophy Account" "{ - \"type\": \"http\", - \"url\": \"https://mcp.trophy.so\", - \"headers\": { - \"x-trophy-api-key\": \"${TROPHY_API_KEY}\" - } - }" - ``` + On first use, Claude Code opens a browser window to complete OAuth login. Sign in to Trophy, select your organization, and authorize access. Verify it appears in your list: @@ -62,31 +53,25 @@ Name this server clearly (for example `Trophy Account`) so it does not collide w { "mcpServers": { "Trophy Account": { - "url": "https://mcp.trophy.so", - "headers": { - "x-trophy-api-key": "YOUR_ADMIN_API_KEY" - } - } - } - } - ``` - - If you prefer not to store the key in the file, use Cursor’s env substitution where available: - - ```json - { - "mcpServers": { - "Trophy Account": { - "url": "https://mcp.trophy.so", - "headers": { - "x-trophy-api-key": "${env:TROPHY_API_KEY}" - } + "url": "https://mcp.trophy.so/mcp" } } } ``` - Restart Cursor if needed so the server and headers load. + Reload Cursor if needed, then complete the OAuth login when prompted. + + + Custom MCP apps require a paid ChatGPT plan (Plus, Pro, Business, Enterprise, or Edu) with [Developer mode](https://platform.openai.com/docs/guides/developer-mode) enabled. + + 1. In ChatGPT, open **Settings → Security and login** and turn on **Developer mode**. + 2. In a chat, open the plus menu and create a developer-mode app for your remote MCP server. + 3. Add: + - Name: `Trophy Account` + - URL: `https://mcp.trophy.so/mcp` + - Authentication: **OAuth** + 4. Complete the OAuth login when prompted. Sign in to Trophy and select your organization. + 5. In chat, choose **Developer mode** from the plus menu and select the Trophy Account app so ChatGPT can call its tools. Create or update `.vscode/mcp.json` in your workspace: @@ -96,34 +81,25 @@ Name this server clearly (for example `Trophy Account`) so it does not collide w "servers": { "Trophy Account": { "type": "http", - "url": "https://mcp.trophy.so", - "headers": { - "x-trophy-api-key": "YOUR_ADMIN_API_KEY" - } + "url": "https://mcp.trophy.so/mcp" } } } ``` - Reload VS Code and enable the server. + Reload VS Code, enable the server, and complete the OAuth login when prompted. - Any MCP client that supports remote HTTP servers and a `headers` config can connect. + Any MCP client that supports remote HTTP servers and OAuth can connect. Use: - **Transport:** HTTP (streamable HTTP) - - **URL:** `https://mcp.trophy.so` + - **URL:** `https://mcp.trophy.so/mcp` - **Name:** `Trophy Account` (or any label you prefer) - - **headers:** + - **Auth:** OAuth (browser login to your Trophy account; no `headers` or API key) - ```json - { - "headers": { - "x-trophy-api-key": "YOUR_ADMIN_API_KEY" - } - } - ``` + After adding the server, complete the OAuth flow and enable the server in the client UI if required. @@ -135,13 +111,7 @@ Ask your agent something that requires a live account call, for example: List the metrics in my Trophy account. ``` -If authentication succeeded, you should get metrics from your organization. If you get an auth or unauthorized error, confirm the key is valid and that your client’s config includes: - -```json -"headers": { - "x-trophy-api-key": "YOUR_ADMIN_API_KEY" -} -``` +If authentication succeeded, you should get metrics from your organization. If you get an auth or unauthorized error, reconnect the server and complete the OAuth login again, making sure you select the correct Trophy organization. ## Next Steps {#next-steps} diff --git a/mcp/account-mcp-server/introduction.mdx b/mcp/account-mcp-server/introduction.mdx index 59b862c..12bcede 100644 --- a/mcp/account-mcp-server/introduction.mdx +++ b/mcp/account-mcp-server/introduction.mdx @@ -9,7 +9,7 @@ The Account MCP Server is a remote [Model Context Protocol](https://modelcontext Instead of copy-pasting dashboard clicks into chat, you can ask your agent to inspect metrics, create points systems, update leaderboards, restore streaks, and more. ```bash Server URL -https://mcp.trophy.so +https://mcp.trophy.so/mcp ``` ## Why the Account MCP? {#why-the-account-mcp} @@ -28,7 +28,7 @@ Typical workflows include: ## How It Works {#how-it-works} -Trophy hosts a remote MCP endpoint. You install it once in your MCP client, authenticate with an admin API key from the [integrations page](https://app.trophy.so/integration) under a `headers` config (`x-trophy-api-key`), and the client exposes tools your agent can call. +Trophy hosts a remote MCP endpoint. You install it once in your MCP client, sign in with OAuth using your Trophy account (and select the organization to authorize), and the client exposes tools your agent can call. Those tools map to account operations — list/get for discovery, create/update for configuration, and dedicated actions for streak freezes, pauses, restores, settings, and reading analytics. diff --git a/mcp/best-practice.mdx b/mcp/best-practice.mdx index 7a79e3e..bb5baac 100644 --- a/mcp/best-practice.mdx +++ b/mcp/best-practice.mdx @@ -37,7 +37,7 @@ Use the Account MCP when you need to take actions in your Trophy account. Use it - Configure new or update existing resources in your Trophy account via chat. - Complete operational tasks such as granting freezes or restoring streaks. -Access is scoped to a specific Trophy [environment](/platform/environments) via [Admin API keys](/admin-api/authentication). +Access is scoped to the Trophy organization you authorize during OAuth. Tools act on a specific [environment](/platform/environments) (defaults to `production` or pass another key when you have multiple). See [Account MCP capabilities](/mcp/account-mcp-server/capabilities) for more details. From 68a8e0599b392977eab0908b2072ba438a85f875 Mon Sep 17 00:00:00 2001 From: Charlie Hopkins-Brinicombe Date: Wed, 9 Sep 2026 16:21:28 +0100 Subject: [PATCH 2/3] Adjust AI quickstart --- getting-started/quickstart.mdx | 125 +++++++++++++++++++++------------ 1 file changed, 80 insertions(+), 45 deletions(-) diff --git a/getting-started/quickstart.mdx b/getting-started/quickstart.mdx index e36ca7b..1985843 100644 --- a/getting-started/quickstart.mdx +++ b/getting-started/quickstart.mdx @@ -15,28 +15,28 @@ Here you'll integrate your application with Trophy and start building your first - These instructions are for those who prefer to develop using coding agents like Cursor and Claude Code. + These instructions are for using Trophy with AI assistants that support MCP — for example Claude, ChatGPT, Cursor, or Claude Code. - First, [create a new account](https://app.trophy.so/sign-up?utm_source=docs&utm_medium=quickstart) if you don't already have one and head into the [Trophy dashboard](https://app.trophy.so). - - Head through onboarding to get your account set up. + First, [create a new account](https://app.trophy.so/sign-up?utm_source=docs&utm_medium=quickstart) if you don't have one already. Complete onboarding to get your account set up. - - For the best AI setup experience, connect Trophy through MCP: + + Connect both Trophy MCP servers in your AI client for the best experience: - Docs MCP server URL: `https://docs.trophy.so/mcp` (live documentation context) - - Account MCP server URL: `https://mcp.trophy.so/mcp` (account actions — see [MCP](/mcp/overview); OAuth sign-in) + - Account MCP server URL: `https://mcp.trophy.so/mcp` (account actions — OAuth sign-in required) + + Setup guides: [Docs MCP installation](/mcp/docs-mcp-server/installation), [Account MCP installation](/mcp/account-mcp-server/installation). Use the [Docs MCP](/mcp/docs-mcp-server/introduction) as on-demand docs context and the [Account MCP](/mcp/account-mcp-server/introduction) for account changes. Use both for [best practice](/mcp/best-practice). - - Here's a prompt you can use with your coding agent to perform initial Trophy setup: + + Here's a prompt you can use with your AI assistant to perform initial Trophy setup: ` using the Trophy API client, wiring all required user attributes like ID, and using placeholders for all optional attributes like name, email, tz and signUpDate. - 4. Add basic error handling and logging around Trophy API calls. + 1. Detect the backend language/framework in this repo and install the relevant official Trophy SDK (or use HTTP calls if no SDK is available). Report to Trophy support if no SDK is available. + 2. Add `TROPHY_API_KEY` to environment config in a secure way (no secrets committed to git), and wire it into the Trophy SDK client initialization. + 3. Add code to set up metric event tracking for the chosen user activity (ask if not known yet) using the Trophy SDK client, wiring all required user attributes like ID, and using placeholders for all optional attributes like name, email, tz and signUpDate, unless already known or required by the use case. + 4. Add basic error handling and logging around Trophy SDK calls. 5. Add or update a short README section explaining how the integration works and how to extend it. Constraints: - - Use Docs MCP tool results for all Trophy-specific implementation decisions. - - Do not rely on prior memory for Trophy API behavior when MCP provides an answer. + - Use Docs MCP tool results for all Trophy-specific implementation decisions and integrations. + - Do not rely on prior memory for Trophy SDK behavior when MCP provides an answer. - Keep secrets out of source control. - Use existing project patterns and naming conventions. - - Show me a concise summary of changed files and how to test the setup. - - Suggest next steps based on the gamification features Trophy supports. + - Show a concise summary of changed files and how to test the setup. + - Suggest next steps based on the gamification features Trophy supports and the use case. - - Make sure to replace `` with the metric you set up during onboarding. - - This will: 1. Add the relevant [Trophy SDK](/api-reference/client-libraries) to your app based on your tech stack 2. Add a new `TROPHY_API_KEY` variable to your environment settings - 3. Add code to send events to Trophy based on the metric you set up during onboarding. - - - Once the set up is complete, [create an API key](https://app.trophy.so/integration) from the integration page of the Trophy dashboard and add it to your environment. + 3. Add code to track metric events for the chosen user activity using the Trophy SDK client - required for all gamification features. - Once initial setup is complete, use this follow-up prompt to prepare your agent for the next step and have it ask you what to build next: + Once initial setup is complete, pick a common use case and paste the matching prompt into your AI assistant: + + + Build a daily streak feature with Trophy. + + Use the Docs MCP as the source of truth for how streaks work, and the Account MCP to configure my account. + + Goals: + 1. Drive the streak from a core user activity already tracked (or that we should track) as a Trophy metric. + 2. Ensure every user identify/upsert and metric event includes the user's `tz` attribute (IANA timezone). This is required for streaks to evaluate calendar days correctly for each user. + 3. Configure the streak featuer in Trophy using a sensible threshold for the chosen metric. + 4. Enable streak freezes and streak pauses if they fit this product; otherwise omit them and say why. + 5. Wire any app-side reads or UI needed to show the user's current streak, freezes, and pause state. + 6. Summarize what was configured, what code changed, and how to verify the streak end to end. Explicitly explain back why sending `tz` matters for a functioning streak feature. + + + + Build an achievements library with Trophy. + + Use the Docs MCP as the source of truth for achievement types and triggers, and the Account MCP to configure my account. + + Goals: + 1. Create a set of achievements tied to core user actions tracked as Trophy metric events. + 2. Add any one-time API-triggered achievements (and other achievement types) that fit the product. + 3. Wire app-side handling for unlocks and a minimal way to list completed vs incomplete achievements. + 4. Summarize what was configured, what code changed, and how to verify unlocks end to end. + - Prepare to continue my Trophy integration from the existing setup. + Build an XP points system with Trophy. - First, verify the connected Trophy Docs MCP server is available and use it as the source of truth for feature-specific integration details. + Use the Docs MCP as the source of truth for points systems, triggers, and levels, and the Account MCP to configure my account. - Before implementing anything, ask me which gamification feature I want to build, providing options based on what the Docs MCP says Trophy supports. + Goals: + 1. Create a points system that awards XP for a few key user actions tracked as Trophy metrics. + 2. Configure triggers in the points system to award XP for the chosen user actions. + 3. Configure levels and boosts if relevant for the use case. + 4. Wire app-side reads or UI needed to show the user's XP total and level progress. + 5. Summarize what was configured, what code changed, and how to verify points awards end to end. + - After I choose one option: - 1. Configure the selected feature in the way I describe using the Account MCP server. - 1. Implement only that selected feature using the relevant Trophy APIs and existing project patterns. - 2. Add the required server-side calls/endpoints/actions that use Trophy APIs and a minimal UI or API response surface. - 3. Document any new env vars, routes, and usage steps. + + Build a repeating weekly leaderboard with Trophy. - If I ask for a feature Trophy does not support, do not implement a workaround. - Instead, tell me it's not currently supported and ask me to contact Trophy support at support@trophy.so to submit a feature request. + Use the Docs MCP as the source of truth for leaderboards, and the Account MCP to configure my account. - Keep changes production-minded: - - Follow existing architecture and naming conventions. - - Handle API failures gracefully. - - Return a clear list of changed files and manual verification steps. + Goals: + 1. Create a weekly recurring leaderboard driven by a core user action tracked as a Trophy metric. + 2. Configure ranking logic based on the chosen metric and configure the weekly reset schedule for the leaderboard. + 3. Wire app-side reads or UI needed to show rankings for the current week and the current user's place. + 4. Summarize what was configured, what code changed, and how to verify rankings end to end. - For ideas on what to build next, explore: + For more ideas on what to build next, explore: @@ -146,13 +183,11 @@ Here you'll integrate your application with Trophy and start building your first Drive automated notification flows using personalized gamification data. - - Or, explore our [API reference](/api-reference/introduction) to get familiar with what Trophy can do. - These instructions are for those who want to implement Trophy by hand. If instead you prefer to use coding agents, switch tabs above. + These instructions are for those who want to implement Trophy by hand. If instead you prefer to use AI, switch tabs above. From 24379fa32962ea10d3711f07ef964b030775c713 Mon Sep 17 00:00:00 2001 From: Charlie Hopkins-Brinicombe Date: Wed, 9 Sep 2026 16:37:32 +0100 Subject: [PATCH 3/3] Translations and typos --- es/getting-started/quickstart.mdx | 199 ++++++++++++--------- es/mcp/account-mcp-server/capabilities.mdx | 86 ++++----- es/mcp/account-mcp-server/installation.mdx | 127 +++++-------- es/mcp/account-mcp-server/introduction.mdx | 34 ++-- es/mcp/best-practice.mdx | 42 ++--- es/uikit/overview.mdx | 18 +- i18n.lock | 158 ++++++++-------- mcp/account-mcp-server/installation.mdx | 4 +- uikit/overview.mdx | 2 +- 9 files changed, 338 insertions(+), 332 deletions(-) diff --git a/es/getting-started/quickstart.mdx b/es/getting-started/quickstart.mdx index d73bdce..9cddfaf 100644 --- a/es/getting-started/quickstart.mdx +++ b/es/getting-started/quickstart.mdx @@ -2,7 +2,7 @@ title: Inicio rápido description: Comienza a usar Trophy en menos de 10 minutos og:description: Sigue esta guía de inicio rápido para integrar Trophy en tu - backend y añadir funciones gamificadas como logros y rachas a tu aplicación. + backend y añadir funciones gamificadas como logros y rachas en tu aplicación. --- import SdkInstallCommand from "../../snippets/sdk-install-command.mdx"; @@ -11,32 +11,32 @@ import TrophyClientInitBlock from "../../snippets/trophy-client-init-block.mdx"; import MetricChangeRequestBlock from "../../snippets/metric-change-request-block.mdx"; import MetricChangeResponseBlock from "../../snippets/metric-change-response-block.mdx"; -Aquí integrarás tu aplicación con Trophy y comenzarás a construir tu primera funcionalidad gamificada. +Aquí integrarás tu aplicación con Trophy y comenzarás a construir tu primera función gamificada. - Estas instrucciones son para quienes prefieren desarrollar usando agentes de código como Cursor y Claude Code. + Estas instrucciones son para usar Trophy con asistentes de IA que soporten MCP — por ejemplo Claude, ChatGPT, Cursor o Claude Code. - Primero, [crea una nueva cuenta](https://app.trophy.so/sign-up?utm_source=docs&utm_medium=quickstart) si aún no tienes una y dirígete al [panel de Trophy](https://app.trophy.so). - - Completa el proceso de incorporación para configurar tu cuenta. + Primero, [crea una cuenta nueva](https://app.trophy.so/sign-up?utm_source=docs&utm_medium=quickstart) si aún no tienes una. Completa la incorporación para configurar tu cuenta. - - Para obtener la mejor experiencia de configuración con IA, conecta Trophy a través de MCP: + + Conecta ambos servidores MCP de Trophy en tu cliente de IA para obtener la mejor experiencia: - URL del servidor MCP de documentación: `https://docs.trophy.so/mcp` (contexto de documentación en vivo) - - URL del servidor MCP de cuenta: `https://mcp.trophy.so` (acciones de cuenta — consulta [MCP](/es/mcp/overview); requiere `x-trophy-api-key`) + - URL del servidor MCP de cuenta: `https://mcp.trophy.so/mcp` (acciones de cuenta — inicio de sesión OAuth requerido) + + Guías de configuración: [Instalación de MCP de documentación](/es/mcp/docs-mcp-server/installation), [Instalación de MCP de cuenta](/es/mcp/account-mcp-server/installation). - Usa el [MCP de documentación](/es/mcp/docs-mcp-server/introduction) como contexto de documentación bajo demanda y el [MCP de cuenta](/es/mcp/account-mcp-server/introduction) para cambios en la cuenta. Usa ambos para seguir las [mejores prácticas](/es/mcp/best-practice). + Usa el [MCP de documentación](/es/mcp/docs-mcp-server/introduction) como contexto de documentación bajo demanda y el [MCP de cuenta](/es/mcp/account-mcp-server/introduction) para cambios de cuenta. Usa ambos para [mejores prácticas](/es/mcp/best-practice). - - Aquí tienes un prompt que puedes usar con tu agente de código para realizar la configuración inicial de Trophy: + + Aquí tienes un prompt que puedes usar con tu asistente de IA para realizar la configuración inicial de Trophy: - Estoy agregando gamificación a mi aplicación usando Trophy. + Estoy añadiendo gamificación a mi aplicación usando Trophy. - Antes de realizar cambios, verifica que los servidores MCP de Trophy conectados estén disponibles. Usa el servidor MCP de documentación como la fuente principal de información para los detalles de integración de Trophy, y el servidor MCP de cuenta para configurar mi cuenta. + Antes de hacer cambios, verifica que los servidores MCP de Trophy conectados estén disponibles. Usa el servidor MCP de documentación como la fuente principal de información para los detalles de integración de Trophy, y el servidor MCP de cuenta para configurar mi cuenta. - Por favor, realiza la configuración inicial completa de principio a fin: - 1. Detecta el lenguaje/framework del backend en este repositorio e instala el SDK oficial de Trophy correspondiente (o usa llamadas HTTP si no hay un SDK disponible). - 2. Agrega `TROPHY_API_KEY` a la configuración de entorno de forma segura (sin secretos confirmados en git), e intégralo en la inicialización del cliente de Trophy. - 3. Agrega código para rastrear un evento de cambio de métrica para la métrica `` usando el cliente de la API de Trophy, conectando todos los atributos de usuario requeridos como el ID, y usando marcadores de posición para todos los atributos opcionales como nombre, correo electrónico, zona horaria y fecha de registro. - 4. Agrega manejo de errores básico y registro en torno a las llamadas a la API de Trophy. - 5. Agrega o actualiza una sección breve en el README que explique cómo funciona la integración y cómo extenderla. + Realiza la configuración inicial completa de principio a fin: + 1. Detecta el lenguaje/framework del backend en este repositorio e instala el SDK oficial de Trophy correspondiente (o utiliza llamadas HTTP si no hay SDK disponible). Informa al soporte de Trophy si no hay SDK disponible. + 2. Agrega `TROPHY_API_KEY` a la configuración de entorno de forma segura (sin secretos comprometidos en git), e intégralo en la inicialización del cliente del SDK de Trophy. + 3. Agrega código para configurar el seguimiento de eventos de métricas para la actividad de usuario elegida (pregunta si aún no se conoce) usando el cliente del SDK de Trophy, conectando todos los atributos de usuario requeridos como ID, y usando marcadores de posición para todos los atributos opcionales como nombre, email, zona horaria y fecha de registro, a menos que ya se conozcan o sean requeridos por el caso de uso. + 4. Agrega manejo básico de errores y registro de eventos alrededor de las llamadas al SDK de Trophy. + 5. Agrega o actualiza una breve sección en el README explicando cómo funciona la integración y cómo ampliarla. Restricciones: - - Utiliza los resultados de la herramienta Docs MCP para todas las decisiones de implementación específicas de Trophy. - - No te bases en la memoria previa para el comportamiento de la API de Trophy cuando MCP proporciona una respuesta. + - Utiliza los resultados de la herramienta Docs MCP para todas las decisiones de implementación e integraciones específicas de Trophy. + - No te bases en memoria previa para el comportamiento del SDK de Trophy cuando MCP proporcione una respuesta. - Mantén los secretos fuera del control de código fuente. - Usa los patrones y convenciones de nomenclatura del proyecto existentes. - - Muéstrame un resumen conciso de los archivos modificados y cómo probar la configuración. - - Sugiere los siguientes pasos basándote en las funcionalidades de gamificación que Trophy admite. + - Muestra un resumen conciso de los archivos modificados y cómo probar la configuración. + - Sugiere los próximos pasos basándote en las funciones de gamificación que Trophy soporta y el caso de uso. - - Asegúrate de reemplazar `` con la métrica que configuraste durante la incorporación. - - Esto hará lo siguiente: - 1. Agregará el [SDK de Trophy](/es/api-reference/client-libraries) relevante a tu aplicación según tu stack tecnológico - 2. Agregará una nueva variable `TROPHY_API_KEY` a tu configuración de entorno - 3. Agregará código para enviar eventos a Trophy basándose en la métrica que configuraste durante la incorporación. - - - Una vez completada la configuración, [crea una clave de API](https://app.trophy.so/integration) desde la página de integración del panel de Trophy y agrégala a tu entorno. + 1. Agregar el [SDK de Trophy](/es/api-reference/client-libraries) relevante a tu aplicación según tu stack tecnológico + 2. Agregar una nueva variable `TROPHY_API_KEY` a tu configuración de entorno + 3. Agregar código para rastrear eventos de métricas para la actividad de usuario elegida usando el cliente del SDK de Trophy - requerido para todas las funciones de gamificación. - - Una vez completada la configuración inicial, usa este prompt de seguimiento para preparar tu agente para el siguiente paso y haz que te pregunte qué construir a continuación: + + Una vez completada la configuración inicial, elige un caso de uso común y pega el prompt correspondiente en tu asistente de IA: + + + Crea una función de racha diaria con Trophy. + + Usa el MCP de Docs como fuente de referencia para cómo funcionan las rachas, y el MCP de Account para configurar mi cuenta. + + Objetivos: + 1. Impulsa la racha desde una actividad de usuario principal ya rastreada (o que debería rastrearse) como una métrica de Trophy. + 2. Asegúrate de que cada identificación/actualización de usuario y evento de métrica incluya el atributo `tz` del usuario (zona horaria IANA). Esto es necesario para que las rachas evalúen correctamente los días calendario para cada usuario. + 3. Configura la función de racha en Trophy usando un umbral sensato para la métrica elegida. + 4. Habilita los congelamientos de racha y las pausas de racha si se ajustan a este producto; de lo contrario, omítelos y explica por qué. + 5. Conecta cualquier lectura del lado de la aplicación o interfaz necesaria para mostrar la racha actual del usuario, los congelamientos y el estado de pausa. + 6. Resume qué se configuró, qué código cambió y cómo verificar la racha de extremo a extremo. Explica explícitamente por qué enviar `tz` es importante para que funcione correctamente la función de racha. + + + + Crea una biblioteca de logros con Trophy. + + Usa el MCP de Docs como fuente de referencia para los tipos de logros y disparadores, y el MCP de Account para configurar mi cuenta. + + Objetivos: + 1. Crea un conjunto de logros vinculados a acciones de usuario principales rastreadas como eventos de métrica de Trophy. + 2. Agrega cualquier logro único activado por API (y otros tipos de logros) que se ajusten al producto. + 3. Conecta el manejo del lado de la aplicación para los desbloqueos y una forma mínima de listar logros completados vs incompletos. + 4. Resume qué se configuró, qué código cambió y cómo verificar los desbloqueos de extremo a extremo. + - Prepárate para continuar mi integración de Trophy desde la configuración existente. + Construye un sistema de Puntos XP con Trophy. - Primero, verifica que el servidor Docs MCP de Trophy conectado esté disponible y úsalo como fuente confiable para los detalles de integración específicos de cada funcionalidad. + Utiliza el MCP de Documentación como fuente de verdad para sistemas de Puntos, activadores y niveles, y el MCP de Cuenta para configurar mi cuenta. - Antes de implementar cualquier cosa, pregúntame qué funcionalidad de gamificación quiero construir, proporcionando opciones basadas en lo que el Docs MCP indica que Trophy admite. + Objetivos: + 1. Crear un sistema de Puntos que otorgue XP por algunas acciones clave del usuario rastreadas como Métricas de Trophy. + 2. Configurar activadores en el sistema de Puntos para otorgar XP por las acciones de usuario elegidas. + 3. Configurar niveles e impulsos si son relevantes para el caso de uso. + 4. Conectar lecturas del lado de la aplicación o interfaz necesaria para mostrar el total de XP del usuario y el progreso de nivel. + 5. Resumir qué se configuró, qué código cambió y cómo verificar las asignaciones de Puntos de extremo a extremo. + - Después de que elija una opción: - 1. Configurar la funcionalidad seleccionada de la manera que describo usando el servidor MCP de Account. - 1. Implementar únicamente esa funcionalidad seleccionada usando las API de Trophy relevantes y los patrones existentes del proyecto. - 2. Agregar las llamadas/endpoints/acciones del lado del servidor necesarias que usan las API de Trophy y una interfaz de usuario mínima o superficie de respuesta de API. - 3. Documentar cualquier nueva variable de entorno, ruta y pasos de uso. + + Construye una Clasificación semanal recurrente con Trophy. - Si solicito una funcionalidad que Trophy no admite, no implementes una solución alternativa. - En su lugar, indícame que actualmente no está disponible y pídeme que me comunique con el soporte de Trophy en support@trophy.so para enviar una solicitud de funcionalidad. + Utiliza el MCP de Documentación como fuente de verdad para Clasificaciones, y el MCP de Cuenta para configurar mi cuenta. - Mantén los cambios orientados a producción: - - Sigue la arquitectura y las convenciones de nomenclatura existentes. - - Maneja los fallos de API de forma elegante. - - Devuelve una lista clara de archivos modificados y pasos de verificación manual. + Objetivos: + 1. Crear una Clasificación recurrente semanal impulsada por una acción principal del usuario rastreada como una Métrica de Trophy. + 2. Configurar la lógica de clasificación basada en la Métrica elegida y configurar el programa de reinicio semanal para la Clasificación. + 3. Conectar lecturas del lado de la aplicación o interfaz necesaria para mostrar clasificaciones de la semana actual y el lugar del usuario actual. + 4. Resumir qué se configuró, qué código cambió y cómo verificar las clasificaciones de extremo a extremo. - Para obtener ideas sobre qué construir a continuación, explora: + Para más ideas sobre qué construir a continuación, explora: - Recompensa a los usuarios por su progreso continuo o por realizar acciones específicas. + Recompensa a los usuarios por el progreso continuo o por realizar acciones específicas. - Motiva a los usuarios a desarrollar hábitos de uso regular. + Motiva a los usuarios a construir hábitos de uso regulares. - Construye sistemas sofisticados de puntos para recompensar y retener usuarios. + Construye sistemas sofisticados de Puntos para recompensar y retener usuarios. - Envía correos electrónicos personalizados del ciclo de vida a los usuarios en el momento perfecto. + Entrega correos electrónicos personalizados de ciclo de vida a los usuarios en el momento perfecto. - Impulsa flujos de notificaciones automatizados usando datos de gamificación personalizados. + Impulsa flujos de notificaciones automatizadas utilizando datos de gamificación personalizados. - - O explora nuestra [referencia de API](/es/api-reference/introduction) para familiarizarte con lo que Trophy puede hacer. - Estas instrucciones son para quienes desean implementar Trophy manualmente. Si en su lugar prefieres usar agentes de codificación, cambia de pestaña arriba. + Estas instrucciones son para quienes desean implementar Trophy manualmente. Si prefieres usar IA, cambia de pestaña arriba. Primero, [crea una nueva cuenta](https://app.trophy.so/sign-up?utm_source=docs&utm_medium=quickstart) si aún no tienes una y dirígete al [panel de Trophy](https://app.trophy.so). - Completa el proceso de incorporación para configurar tu cuenta. + Completa la configuración inicial para preparar tu cuenta. - - Tenemos bibliotecas de SDK disponibles en la mayoría de los lenguajes de programación principales, pero si no ves el tuyo en la lista, ¡háznoslo saber y crearemos uno! + + Tenemos bibliotecas del SDK disponibles en los principales lenguajes de programación, pero si no encuentras el tuyo en la lista, ¡avísanos y crearemos uno! @@ -172,20 +207,20 @@ Aquí integrarás tu aplicación con Trophy y comenzarás a construir tu primera Dirígete a la [página de integración](https://app.trophy.so/integration) del panel de Trophy y crea una nueva clave de API. - Agrega tu clave de API como una variable de entorno en tu aplicación de backend: + Añade tu clave de API como variable de entorno en tu aplicación backend: - Luego inicializa el cliente de API de Trophy en tu backend usando esa clave de API: + Luego inicializa el cliente de la API de Trophy en tu backend usando esa clave de API: - Asegúrate de que todas las llamadas al SDK de Trophy usen este cliente para la autenticación. + Asegúrate de que todas las llamadas al SDK de Trophy utilicen este cliente para la autenticación. - Todas las funciones de gamificación están impulsadas por interacciones de usuario. En Trophy, usas [Métricas](/es/features/metrics) para definir y modelar esas interacciones y [Eventos](/es/features/events) para rastrearlas. + Todas las funciones de gamificación se basan en interacciones de usuarios. En Trophy, usas [Métricas](/es/features/metrics) para definir y modelar esas interacciones y [Eventos](/es/features/events) para rastrearlas. - Aquí crearás tu primera métrica para comenzar. En el panel de Trophy, dirígete a la [página de métricas](https://app.trophy.so/metrics) y haz clic en el botón _Nueva Métrica_: + Aquí crearás tu primera métrica para comenzar. En el panel de Trophy, dirígete a la [página de métricas](https://app.trophy.so/metrics) y presiona el botón _Nueva Métrica_: - Dale un nombre a la métrica y haz clic en _Guardar_. + Dale un nombre a la métrica y presiona _Guardar_. - Una vez que hayas creado tu métrica, dirígete a la pestaña de configuración y copia su clave de referencia única de la API. + Una vez que hayas creado tu métrica, dirígete a la pestaña de configuración y copia su clave de referencia de API única. - Para rastrear un evento contra esta métrica cuando un usuario interactúa con tu producto, llama a la [API de eventos de cambio de métrica](/es/api-reference/endpoints/events/submit-a-metric-event), pasando los detalles del usuario que realizó la interacción. En este ejemplo, la clave de la métrica sería `flashcards-flipped`: + Para rastrear un evento asociado a esta métrica cuando un usuario interactúa con tu producto, llama a la [API de eventos de cambio de métrica](/es/api-reference/endpoints/events/submit-a-metric-event), pasando los detalles del usuario que realizó la interacción. En este ejemplo, la clave de métrica sería `flashcards-flipped`: - Al realizar esta llamada, le estás indicando a Trophy que un usuario específico realizó una interacción con tu producto. Como resultado, Trophy procesará automáticamente cualquier funcionalidad de gamificación como Logros o Rachas que hayas configurado contra la métrica. + Al realizar esta llamada, le estás indicando a Trophy que un usuario específico ha interactuado con tu producto. Como resultado, Trophy procesará automáticamente cualquier función de gamificación, como logros o rachas, que hayas configurado para la métrica. - Con una métrica integrada en tu backend, estás listo para comenzar a agregar funcionalidades de gamificación a tu producto. + Con una métrica integrada en tu backend, estás listo para comenzar a agregar funciones de gamificación a tu producto. - Sigue los enlaces a continuación para aprender más sobre cada funcionalidad que puedes construir con Trophy: + Sigue los enlaces a continuación para obtener más información sobre cada función que puedes crear con Trophy: - Recompensa a los usuarios por su progreso continuo o por tomar acciones específicas. + Recompensa a los usuarios por su progreso continuo o por realizar acciones específicas. Motiva a los usuarios a desarrollar hábitos de uso regular. - Construye sistemas sofisticados de puntos para recompensar y retener usuarios. + Crea sistemas de puntos sofisticados para recompensar y retener usuarios. } href="/es/features/leaderboards"> - Crea competencias amistosas para aumentar la participación de los usuarios. + Crea competencias amistosas para aumentar el engagement de los usuarios. - Entrega correos electrónicos personalizados del ciclo de vida a los usuarios en el momento perfecto. + Envía correos electrónicos personalizados del ciclo de vida a los usuarios en el momento perfecto. - Impulsa flujos de notificación automatizados utilizando datos personalizados de gamificación. + Impulsa flujos de notificaciones automatizados utilizando datos de gamificación personalizados. @@ -272,6 +307,6 @@ Aquí integrarás tu aplicación con Trophy y comenzarás a construir tu primera -## Obtener Soporte {#get-support} +## Obtener soporte {#get-support} -¿Quieres ponerte en contacto con el equipo de Trophy? Contáctanos por [correo electrónico](mailto:support@trophy.so). ¡Estamos aquí para ayudarte! +¿Quieres contactar con el equipo de Trophy? Contáctanos por [correo electrónico](mailto:support@trophy.so). ¡Estamos aquí para ayudarte! diff --git a/es/mcp/account-mcp-server/capabilities.mdx b/es/mcp/account-mcp-server/capabilities.mdx index c75a0d2..544899c 100644 --- a/es/mcp/account-mcp-server/capabilities.mdx +++ b/es/mcp/account-mcp-server/capabilities.mdx @@ -1,20 +1,20 @@ --- title: Capacidades -description: Aprende sobre lo que puede hacer el servidor MCP de cuenta Trophy. -og:description: Aprende sobre lo que puede hacer el servidor MCP de cuenta Trophy. +description: Aprende sobre lo que puede hacer el servidor MCP de cuenta de Trophy. +og:description: Aprende sobre lo que puede hacer el servidor MCP de cuenta de Trophy. icon: wrench --- 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 emparejadas de **lectura** y **escritura**: - Las herramientas de **lectura** listan y obtienen recursos - Las herramientas de **escritura** crean o actualizan recursos en lote para acelerar las operaciones ## Referencia de herramientas {#tool-reference} -La lista completa de herramientas disponibles en el servidor MCP de cuenta Trophy. +La lista completa de herramientas disponibles en el servidor MCP de cuenta de Trophy. ### Herramientas de métricas {#metrics-tools} @@ -22,7 +22,7 @@ Crea y gestiona las [Métricas](/es/features/metrics) que impulsan rachas, logro | Herramienta | Qué hace | | --- | --- | -| `read_metrics` | Lista métricas u obtiene una única métrica 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} @@ -31,48 +31,48 @@ Gestiona [Atributos de usuario personalizados](/es/features/users#custom-user-at | Herramienta | Qué hace | | --- | --- | -| `read_attributes` | Lista atributos u obtiene un único atributo por ID | +| `read_attributes` | Lista atributos, u obtiene un atributo individual por ID | | `write_attributes` | Crea o actualiza atributos | ### Herramientas de logros {#achievements-tools} -Configura [Logros](/es/features/achievements) y lee analíticas de finalización para tu cuenta. +Configura [Logros](/es/features/achievements) y consulta análisis de completitud para tu cuenta. | Herramienta | Qué hace | | --- | --- | -| `read_achievements` | Lista logros u obtiene un único logro por ID | +| `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` | +| `read_achievements_analytics` | Lista logros con conteos de completitud y rareza; opcionalmente filtra por `user_attributes` | ### Herramientas de clasificaciones {#leaderboards-tools} -Configura [Clasificaciones](/es/features/leaderboards) y lee rankings en vivo. +Configura [Clasificaciones](/es/features/leaderboards) y consulta rankings en vivo. | Herramienta | Qué hace | | --- | --- | | `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 tiempo real por clave (paginación opcional, fecha de ejecución, centrado de usuario y filtros de atributos) | +| `read_leaderboard_rankings` | Obtener una clasificación con rankings en vivo por clave (paginación, fecha de ejecución, centrado de usuario y filtros de atributos opcionales) | ### Herramientas de Puntos {#points-tools} -Configure sistemas completos de [Puntos](/es/features/points), incluyendo [Disparadores](/es/features/points#points-triggers), [Niveles](/es/features/points#points-levels) y [Impulsos](/es/features/points#points-boosts), y consulte análisis de distribución. +Configure sistemas completos de [Puntos](/es/features/points), incluyendo [Desencadenadores](/es/features/points#points-triggers), [Niveles](/es/features/points#points-levels) y [Impulsos](/es/features/points#points-boosts), y consulte análisis de distribución. | Herramienta | Qué hace | | --- | --- | | `read_points_systems` | Listar sistemas de puntos u obtener uno por ID | -| `write_points_systems` | Crear o actualizar sistemas de puntos (opcionalmente con disparadores, niveles e impulsos anidados) | -| `read_points_triggers` | Listar u obtener disparadores para un sistema de puntos | -| `write_points_triggers` | Crear o actualizar disparadores 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 impulsos para un sistema de puntos | -| `write_points_boosts` | Crear o actualizar impulsos para un sistema de puntos | -| `read_points_analytics` | Distribución de puntos y desgloses de niveles para un sistema (`summary` o `level_summary`; `user_attributes` opcional en el resumen) | +| `write_points_systems` | Crear o actualizar sistemas de puntos (opcionalmente con desencadenadores, niveles e impulsos anidados) | +| `read_points_triggers` | Listar u obtener desencadenadores de un sistema de puntos | +| `write_points_triggers` | Crear o actualizar desencadenadores de un sistema de puntos | +| `read_points_levels` | Listar u obtener niveles de un sistema de puntos | +| `write_points_levels` | Crear o actualizar niveles de un sistema de puntos | +| `read_points_boosts` | Listar u obtener impulsos de un sistema de puntos | +| `write_points_boosts` | Crear o actualizar impulsos de 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} -Administre registros de organizaciones [Multi-Cliente](/es/platform/multi-tenancy) cuando la multi-tenencia esté habilitada en su cuenta. +Gestione registros de organizaciones [Multi-Cliente](/es/platform/multi-tenancy) cuando la funcionalidad multi-cliente esté habilitada en su cuenta. | Herramienta | Qué hace | | --- | --- | @@ -80,7 +80,7 @@ Administre registros de organizaciones [Multi-Cliente](/es/platform/multi-tenanc | `write_tenants` | Crear o actualizar clientes | -Si la multi-tenencia no está habilitada en su cuenta, estas herramientas no funcionarán. +Si la funcionalidad multi-cliente no está habilitada en su cuenta, estas herramientas no funcionarán. ### Herramientas de Entornos {#environments-tools} @@ -89,18 +89,18 @@ Lista los [Entornos](/es/platform/environments) en tu cuenta de Trophy. | Herramienta | Qué hace | | --- | --- | -| `read_environments` | Lista todos los entornos activos ordenados por prioridad (nombre, clave, prioridad; producción siempre es prioridad 1) | +| `read_environments` | Lista todos los entornos activos ordenados por prioridad (nombre, clave, prioridad; producción siempre tiene prioridad 1) | ### Herramientas de Rachas {#streaks-tools} -Consulta y ejecuta acciones operativas 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. +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), creación de [Pausas de Racha](/es/features/streaks#streak-pauses), [restauración de rachas](/es/features/streaks#restoring-a-users-streak), y lectura o actualización de la configuración de rachas de la organización. | Herramienta | Qué hace | | --- | --- | -| `list_user_streaks` | Obtiene la longitud de racha (y marca de tiempo de la última extensión) para hasta 100 usuarios, clasificados de mayor a menor | -| `grant_streak_freezes` | Otorga congelaciones de racha a uno o más usuarios | +| `list_user_streaks` | Obtiene la longitud de la 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 rota a su longitud anterior | -| `create_streak_pauses` | Crea pausas de racha para usuarios en un rango de fechas (hasta 100 por solicitud) | +| `create_streak_pauses` | Crea pausas de racha para usuarios durante un rango de fechas (hasta 100 por solicitud) | | `delete_streak_pauses` | Elimina pausas de racha por ID (hasta 100 por solicitud) | | `get_streak_settings` | Obtiene la configuración de rachas de la organización (frecuencia, modo de evaluación, métricas, días libres, congelaciones) | | `update_streak_settings` | Actualiza la configuración de rachas de la organización | @@ -114,62 +114,64 @@ Lee y actualiza la configuración de la organización, incluyendo [Marca](/es/ac | `get_settings` | Obtiene la configuración de marca, experimentación y período de agregación | | `update_settings` | Actualiza la configuración de marca, experimentación y período de agregación | -## Ejemplos de Prompts {#example-prompts} +## Ejemplos de Instrucciones {#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. +Create an XP system called 'Kudos' that grants 10 points for each workout completed. ``` ```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'). +Schedule 2X XP boosts for the 'Kudos' system across the next 3 weekends (only for paying users - 'plan' attribute is 'pro'). ``` ```text -Lista todos los logros, tasas de finalización y rareza en mi cuenta de Trophy. +List all achievements, completion rates and rarity in my Trophy account. ``` ```text -Obtén el top 20 de rankings de la clasificación weekly-workouts de esta semana. +Get the top 20 rankings for leaderboard weekly-workouts this week. ``` ```text -Resume la distribución de puntos de Kudos para usuarios pro. +Summarize the Kudos points distribution for pro users. ``` ```text -¿Cuáles son las longitudes de racha actuales de los usuarios user_123 y user_456? +What are the current streak lengths for users user_123 and user_456? ``` ```text -Otorga dos congelaciones de racha al usuario user_123. +Grant two streak freezes to user user_123. ``` ```text -user_123 quiere recuperar su racha, restáurala a su longitud anterior. +user_123 wants their streak back, restore it to its previous length. ``` ```text -Crea una pausa de racha para user_123 desde 2026-09-15 hasta 2026-09-22 mientras está de vacaciones. +Create a streak pause for user_123 from 2026-09-15 to 2026-09-22 while they're on holiday. ``` ```text -¿Cuál es nuestra configuración actual de rachas, y configura las congelaciones para empezar con 1 y un máximo de 3? +What is our current streak configuration, and set freezes to start with 1 and max out at 3? ``` ```text -Crea un logro llamado 'Primer Entrenamiento' que se desbloquea cuando los usuarios completan 1 entrenamiento. +Create an achievement called 'First Workout' that unlocks when users complete 1 workout. ``` ```text -Actualiza nuestro color de marca a #0F766E y configura el período de agregación en semanal. +Update our brand color to #0F766E and set the aggregation period to weekly. ``` ## Alcance y seguridad {#scope-and-safety} -- Las herramientas solo actuarán sobre el [entorno](/es/platform/environments) de Trophy vinculado a la clave de API que proporciones en `x-trophy-api-key`. -- Las herramientas de escritura pueden modificar la configuración en producción. Preferiblemente utiliza un [entorno](/es/platform/environments) de staging o sandbox al iterar. +- El acceso está limitado a la organización de Trophy que autorices durante OAuth. +- Las herramientas actúan en un [entorno](/es/platform/environments) específico. Si la cuenta tiene solo uno, las llamadas de herramienta usan ese por defecto (normalmente `production`). Si hay múltiples, pasa la clave `environment` que desees, o usa `read_environments` para listarlos y elegir. +- Cuando la [multi-tenencia](/es/platform/multi-tenancy) está habilitada, las herramientas también pueden estar limitadas a un [cliente](/es/platform/multi-tenancy). Si hay solo un cliente activo, las llamadas de herramienta pueden usar ese por defecto. Si hay múltiples, pasa el id `tenant` que desees, o usa `read_tenants` para listarlos y elegir. +- Las herramientas de escritura pueden cambiar la configuración en producción. Prefiere un [entorno](/es/platform/environments) de staging o sandbox cuando estés iterando. - 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} diff --git a/es/mcp/account-mcp-server/installation.mdx b/es/mcp/account-mcp-server/installation.mdx index 154a174..4a4aaf7 100644 --- a/es/mcp/account-mcp-server/installation.mdx +++ b/es/mcp/account-mcp-server/installation.mdx @@ -1,8 +1,8 @@ --- title: Instalación -description: Instala el servidor MCP de cuenta en Claude Code, Cursor, VS Code y - otros clientes MCP. -subtitle: Conecta el servidor MCP de cuenta remoto a tu agente de codificación. +description: Instala el servidor MCP de cuenta en Claude, Claude Code, Cursor, + ChatGPT, VS Code y otros clientes MCP. +subtitle: Conecta el servidor MCP de cuenta remoto a tu agente de programación. icon: download --- @@ -10,45 +10,36 @@ icon: download Necesitas una [cuenta de Trophy](https://app.trophy.so/sign-up) para usar el servidor MCP de cuenta de Trophy. -El servidor MCP de cuenta de Trophy es un servidor MCP HTTP remoto. Diriges tu cliente a la URL indicada a continuación usando tu [clave API de administrador](/es/admin-api/authentication) y tu agente podrá comenzar a usar las herramientas. +El servidor MCP de cuenta de Trophy es un servidor MCP HTTP remoto. Apunta tu cliente a la URL que aparece a continuación, completa el inicio de sesión OAuth con tu cuenta de Trophy cuando se te solicite, y tu agente podrá comenzar a usar las herramientas. ```bash Server URL -https://mcp.trophy.so +https://mcp.trophy.so/mcp ``` -## Instalar en tu cliente {#install-in-your-client} +No se requieren claves de API. La autenticación utiliza OAuth: tu cliente MCP abre un navegador para que puedas iniciar sesión en Trophy y autorizar el acceso para la organización que selecciones. -Nombra este servidor de forma clara (por ejemplo `Trophy Account`) para que no colisione con el [servidor MCP de documentación](/es/mcp/docs-mcp-server/installation). +## Instalar en tu cliente {#install-in-your-client} - - Reemplaza `YOUR_ADMIN_API_KEY` con una clave API de la [página de integraciones](https://app.trophy.so/integration) del panel de Trophy. - +Nombra este servidor claramente (por ejemplo `Trophy Account`) para que no entre en conflicto con el [servidor MCP de documentación](/es/mcp/docs-mcp-server/installation). + + 1. Abre [Conectores de Claude](https://claude.ai/new#settings/customize-connectors). + 2. Selecciona **Agregar > Agregar conector personalizado**. + 3. Agrega: + - Nombre: `Trophy Account` + - URL: `https://mcp.trophy.so/mcp` + 4. Completa el inicio de sesión OAuth cuando se te solicite y selecciona tu organización de Trophy. + 5. En el chat, usa el botón más para habilitar el conector de cuenta de Trophy o escribe 'Usando el servidor MCP de cuenta de Trophy...'. + - Agrega el servidor remoto con una entrada `headers` para la clave API: + Agrega el servidor remoto: ```bash - claude mcp add-json "Trophy Account" '{ - "type": "http", - "url": "https://mcp.trophy.so", - "headers": { - "x-trophy-api-key": "YOUR_ADMIN_API_KEY" - } - }' + claude mcp add --transport http "Trophy Account" https://mcp.trophy.so/mcp ``` - Para obtener la clave desde el entorno en lugar de incluirla directamente: - - ```bash - claude mcp add-json "Trophy Account" "{ - \"type\": \"http\", - \"url\": \"https://mcp.trophy.so\", - \"headers\": { - \"x-trophy-api-key\": \"${TROPHY_API_KEY}\" - } - }" - ``` + En el primer uso, Claude Code abre una ventana del navegador para completar el inicio de sesión OAuth. Inicia sesión en Trophy, selecciona tu organización y autoriza el acceso. Verifica que aparezca en tu lista: @@ -64,31 +55,25 @@ Nombra este servidor de forma clara (por ejemplo `Trophy Account`) para que no c { "mcpServers": { "Trophy Account": { - "url": "https://mcp.trophy.so", - "headers": { - "x-trophy-api-key": "YOUR_ADMIN_API_KEY" - } + "url": "https://mcp.trophy.so/mcp" } } } ``` - Si prefieres no almacenar la clave en el archivo, usa la sustitución de entorno de Cursor donde esté disponible: - - ```json - { - "mcpServers": { - "Trophy Account": { - "url": "https://mcp.trophy.so", - "headers": { - "x-trophy-api-key": "${env:TROPHY_API_KEY}" - } - } - } - } - ``` - - Reinicia Cursor si es necesario para que el servidor y los encabezados se carguen. + Recarga Cursor si es necesario, luego completa el inicio de sesión OAuth cuando se te solicite. + + + Las aplicaciones MCP personalizadas requieren un plan de pago de ChatGPT con el [modo de desarrollador](https://platform.openai.com/docs/guides/developer-mode) habilitado. + + 1. En ChatGPT, abre **Configuración → Seguridad e inicio de sesión** y activa el **Modo de desarrollador**. + 2. En un chat, abre el menú de suma y crea una aplicación en modo de desarrollador para tu servidor MCP remoto. + 3. Añade: + - Nombre: `Trophy Account` + - URL: `https://mcp.trophy.so/mcp` + - Autenticación: **OAuth** + 4. Completa el inicio de sesión OAuth cuando se te solicite. Inicia sesión en Trophy y selecciona tu organización. + 5. En el chat, elige **Modo de desarrollador** desde el menú de suma y selecciona la aplicación Trophy Account para que ChatGPT pueda llamar a sus herramientas. Crea o actualiza `.vscode/mcp.json` en tu espacio de trabajo: @@ -98,68 +83,52 @@ Nombra este servidor de forma clara (por ejemplo `Trophy Account`) para que no c "servers": { "Trophy Account": { "type": "http", - "url": "https://mcp.trophy.so", - "headers": { - "x-trophy-api-key": "YOUR_ADMIN_API_KEY" - } + "url": "https://mcp.trophy.so/mcp" } } } ``` - Recarga VS Code y habilita el servidor. + Recarga VS Code, habilita el servidor y completa el inicio de sesión OAuth cuando se te solicite. - Cualquier cliente MCP que admita servidores HTTP remotos y una configuración `headers` puede conectarse. + Cualquier cliente MCP que soporte servidores HTTP remotos y OAuth puede conectarse. Usa: - - **Transporte:** HTTP (HTTP con streaming) - - **URL:** `https://mcp.trophy.so` + - **Transporte:** HTTP (HTTP transmisible) + - **URL:** `https://mcp.trophy.so/mcp` - **Nombre:** `Trophy Account` (o cualquier etiqueta que prefieras) - - **headers:** - - ```json - { - "headers": { - "x-trophy-api-key": "YOUR_ADMIN_API_KEY" - } - } - ``` + - **Autenticación:** OAuth (inicio de sesión en el navegador a tu cuenta de Trophy; sin `headers` ni clave API) + Después de añadir el servidor, completa el flujo OAuth y habilita el servidor en la interfaz del cliente si es necesario. -## Verificar la conexión {#verify-the-connection} +## Verifica la conexión {#verify-the-connection} -Pregunta a tu agente algo que requiera una llamada a la cuenta activa, por ejemplo: +Pregunta a tu agente algo que requiera una llamada de cuenta en vivo, por ejemplo: ```text List the metrics in my Trophy account. ``` -Si la autenticación fue exitosa, deberías obtener métricas de tu organización. Si recibes un error de autenticación o no autorizado, confirma que la clave sea válida y que la configuración de tu cliente incluya: - -```json -"headers": { - "x-trophy-api-key": "YOUR_ADMIN_API_KEY" -} -``` +Si la autenticación fue exitosa, deberías obtener métricas de tu organización. Si recibes un error de autenticación o no autorizado, reconecta el servidor y completa el inicio de sesión OAuth nuevamente, asegurándote de seleccionar la organización correcta de Trophy. ## Próximos pasos {#next-steps} - Explora qué herramientas expone el servidor MCP de cuenta. + Explora qué herramientas expone el Account MCP Server. - - Agrega contexto de documentación bajo demanda para tu agente. + + Añade contexto de documentación bajo demanda para tu agente. Formas recomendadas de trabajar con agentes y MCP. -## Obtener soporte {#get-support} +## Obtener Soporte {#get-support} ¿Quieres ponerte en contacto con el equipo de Trophy? Contáctanos por [correo electrónico](mailto:support@trophy.so). ¡Estamos aquí para ayudarte! diff --git a/es/mcp/account-mcp-server/introduction.mdx b/es/mcp/account-mcp-server/introduction.mdx index c6fce69..cf73c3e 100644 --- a/es/mcp/account-mcp-server/introduction.mdx +++ b/es/mcp/account-mcp-server/introduction.mdx @@ -1,50 +1,50 @@ --- title: Introducción -description: Conoce el servidor Account MCP y por qué existe para agentes de IA. +description: Aprende sobre el servidor MCP de cuenta 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 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. +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. -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. +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 +https://mcp.trophy.so/mcp ``` -## ¿Por qué el Account MCP? {#why-the-account-mcp} +## ¿Por qué el MCP de cuenta? {#why-the-account-mcp} -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. +Los agentes de codificación de IA ya son donde los equipos diseñan y envían trabajo de producto, y Trophy ha simplificado esto al proporcionar infraestructura prediseñada para construir características comunes de gamificación. Sin embargo, esto implica en gran medida mirar pantallas y hacer clic en botones. -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. +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 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 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 los equipos donde los agentes pueden razonar sobre qué características de gamificación construir, comprender cómo mapear eso a las características 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 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 conceder congelaciones o restaurar Rachas desde el chat +- 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 el código de producción +- Ejecutar tareas operativas como otorgar 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 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. +Trophy aloja un endpoint MCP remoto. Lo instalas una vez en tu cliente MCP, inicias sesión con OAuth usando tu cuenta de Trophy (y seleccionas la organización a autorizar), 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 rachas, pausas, restauraciones, configuración y lectura de analíticas. +Estas herramientas se corresponden con operaciones de cuenta: list/get para descubrimiento, create/update para configuración, y acciones dedicadas para congelaciones de rachas, pausas, restauraciones, ajustes y lectura de analíticas. - 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). + 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 [Admin API](/es/admin-api/introduction). -## Comenzar {#get-started} +## Primeros pasos {#get-started} Conecta el servidor MCP en Claude, Cursor, VS Code y otros clientes. - Consulta las herramientas que tu agente puede usar una vez conectado. + Consulta las herramientas que tu agente puede utilizar una vez conectado. Formas recomendadas de trabajar con agentes y MCP. diff --git a/es/mcp/best-practice.mdx b/es/mcp/best-practice.mdx index bb4d067..5a07478 100644 --- a/es/mcp/best-practice.mdx +++ b/es/mcp/best-practice.mdx @@ -1,10 +1,10 @@ --- title: Mejores Prácticas -description: Cómo usar los servidores MCP de Docs y Account de Trophy juntos. -og:description: Cómo usar los servidores MCP de Docs y Account de Trophy juntos. +description: Cómo usar los servidores MCP de Documentación y Cuenta de Trophy juntos. +og:description: Cómo usar los servidores MCP de Documentación y Cuenta de Trophy juntos. --- -El servidor MCP de Docs de Trophy y el servidor MCP de Account están diseñados para usarse juntos. Esta página cubre las formas recomendadas de utilizarlos. +El Servidor MCP de Documentación de Trophy y el Servidor MCP de Cuenta están diseñados para usarse juntos. Esta página cubre las formas recomendadas de utilizarlos. ## Usar Ambos Servidores Juntos {#using-both-servers-together} @@ -15,40 +15,40 @@ Instala ambos servidores en tu cliente MCP usando nombres distintos para que las | `Trophy Docs` | `https://docs.trophy.so/mcp` | | `Trophy Account` | `https://mcp.trophy.so/mcp` | -Guías de instalación: [MCP de Docs](/es/mcp/docs-mcp-server/installation), [MCP de Account](/es/mcp/account-mcp-server/installation). +Guías de instalación: [MCP de Documentación](/es/mcp/docs-mcp-server/installation), [MCP de Cuenta](/es/mcp/account-mcp-server/installation). -## MCP de Docs: Documentación en Vivo {#docs-mcp-live-documentation} +## MCP de Documentación: Documentación en Vivo {#docs-mcp-live-documentation} -Usa el MCP de Docs como contexto en vivo sobre cómo funciona Trophy. Úsalo cuando necesites: +Usa el MCP de Documentación como contexto en vivo sobre cómo funciona Trophy. Úsalo cuando necesites: - Entender el comportamiento de las funcionalidades de Trophy en detalle -- Generar ideas sobre cómo resolver tu caso de uso específico de gamificación -- Encontrar el API correcto para llamar +- Pensar cómo resolver tu caso de uso específico de gamificación +- Encontrar la API correcta para llamar -El servidor MCP de Docs de Trophy es **de solo lectura** y siempre lee documentación pública en vivo, úsalo en lugar de copias locales para asegurarte de tener la información más actualizada. +El Servidor MCP de Documentación de Trophy es de **solo lectura** y siempre lee documentación pública en vivo, úsalo en lugar de copias locales para asegurar que tienes la información más actualizada. -Consulta las [capacidades del MCP de Docs](/es/mcp/docs-mcp-server/capabilities) para más detalles. +Consulta las [capacidades del MCP de Documentación](/es/mcp/docs-mcp-server/capabilities) para más detalles. -## MCP de Account: Configuración y Operaciones de Cuenta {#account-mcp-account-configuration-and-operations} +## MCP de Cuenta: Configuración y Operaciones de Cuenta {#account-mcp-account-configuration-and-operations} -Usa el MCP de Account cuando necesites realizar acciones en tu cuenta de Trophy. Úsalo cuando necesites: +Usa el MCP de Cuenta cuando necesites realizar acciones en tu cuenta de Trophy. Úsalo cuando necesites: -- Leer la configuración de tu cuenta de Trophy, por ejemplo, métricas, clasificaciones, etc. -- Configurar recursos nuevos o actualizar los existentes en tu cuenta de Trophy mediante chat. -- Completar tareas operativas como conceder congelaciones o restaurar rachas. +- Leer configuración de tu cuenta de Trophy, por ejemplo, métricas, clasificaciones, etc. +- Configurar recursos nuevos o actualizar existentes en tu cuenta de Trophy mediante chat. +- Completar tareas operativas como otorgar congelaciones o restaurar rachas. -El acceso está limitado a un [entorno](/es/platform/environments) específico de Trophy mediante [claves de API de administrador](/es/admin-api/authentication). +El acceso está limitado a la organización de Trophy que autorices durante OAuth. Las herramientas actúan en un [entorno](/es/platform/environments) específico (por defecto `production` o pasa otra clave cuando tengas múltiples). -Consulta las [capacidades del servidor MCP de cuenta](/es/mcp/account-mcp-server/capabilities) para obtener más detalles. +Consulta [Capacidades del servidor MCP de cuenta](/es/mcp/account-mcp-server/capabilities) para más detalles. ## Flujo de trabajo recomendado {#recommended-workflow} -Para la mayoría del trabajo agéntico con Trophy, usa ambos servidores en conjunto: +Para la mayoría del trabajo agéntico con Trophy, utiliza ambos servidores juntos: -1. **MCP de documentación** — carga el comportamiento de la función o API que necesita la tarea +1. **MCP de documentación** — carga la funcionalidad o el comportamiento de API que necesita la tarea 2. **MCP de cuenta (lectura)** — lista los recursos relacionados para que el trabajo se base en lo que ya existe 3. **MCP de cuenta (escritura)** — crea o actualiza solo lo que requiere la tarea -4. **Tu aplicación** — implementa llamadas a la API de aplicación en código usando las estructuras respaldadas por la documentación y tus claves API +4. **Tu aplicación** — implementa las llamadas a la API de aplicación en código usando las estructuras respaldadas por la documentación y tus claves de API 5. **Verificar** — vuelve a leer el estado de la cuenta o la documentación si algo falla ### Ejemplo de prompt {#example-prompt} @@ -62,4 +62,4 @@ Then integrate event tracking to this metric in my code based on the docs. ## Obtener soporte {#get-support} -¿Quieres contactar al equipo de Trophy? Comunícate con nosotros por [correo electrónico](mailto:support@trophy.so). ¡Estamos aquí para ayudarte! +¿Quieres contactar con el equipo de Trophy? Comunícate con nosotros por [correo electrónico](mailto:support@trophy.so). ¡Estamos aquí para ayudarte! diff --git a/es/uikit/overview.mdx b/es/uikit/overview.mdx index 1fa36f5..2ca9560 100644 --- a/es/uikit/overview.mdx +++ b/es/uikit/overview.mdx @@ -11,15 +11,15 @@ title: Kit de UI de Gamificación /> -El Kit de UI de Gamificación de Trophy es una biblioteca de componentes construida sobre [shadcn/ui](https://ui.shadcn.com) que te ayuda a crear experiencias de gamificación más rápido. Proporciona componentes prediseñados para rachas, logros, clasificaciones, puntos y más. +El [Kit de UI de Gamificación](https://ui.trophy.so) de Trophy es una biblioteca de componentes construida sobre [shadcn/ui](https://ui.shadcn.com) que te ayuda a crear experiencias de gamificación más rápido. Proporciona componentes prediseñados para rachas, logros, clasificaciones, puntos y más. -El Kit de UI está diseñado para funcionar con cualquier plataforma de gamificación, pero todas las props y formas de datos están diseñadas intencionalmente para trabajar sin problemas con Trophy. +El Kit de UI está diseñado para funcionar con cualquier plataforma de gamificación, pero todas las props y estructuras de datos están diseñadas intencionalmente para trabajar sin problemas con Trophy. -## Requisitos Previos {#prerequisites} +## Requisitos previos {#prerequisites} - **React 18+** — Los componentes son React del lado del cliente. -- **Tailwind v4+** — El estilo utiliza clases de utilidad de Tailwind. Configura Tailwind para que esas clases se compilen, y agrega los [tokens de tema semántico](https://ui.trophy.so/docs/styles) que Trophy espera (o mapéalos a tu sistema de diseño). -- **Estructura de shadcn/ui** — Mantén un proyecto que ya siga la configuración de [shadcn/ui](https://ui.shadcn.com/docs/installation) (`components.json`, alias y diseño opcional `src/`). +- **Tailwind v4+** — El estilado usa clases de utilidad de Tailwind. Configura Tailwind para que esas clases se compilen, y añade los [tokens de tema semántico](https://ui.trophy.so/docs/styles) que Trophy espera (o mapéalos a tu sistema de diseño). +- **Estructura shadcn/ui** — Mantén un proyecto que ya siga la configuración de [shadcn/ui](https://ui.shadcn.com/docs/installation) (`components.json`, alias y diseño `src/` opcional). ## Comenzar {#getting-started} @@ -29,15 +29,15 @@ Los componentes están disponibles a través del CLI de shadcn: npx shadcn@latest add https://ui.trophy.so/ ``` -Por ejemplo, para instalar el componente Insignia de Racha: +Por ejemplo, para instalar el componente Streak Badge: ```bash npx shadcn@latest add https://ui.trophy.so/streak-badge ``` -Una vez que un componente está instalado, puedes importarlo y usarlo como cualquier otro componente de React. Los archivos se agregan a tu proyecto (el mismo modelo de [código abierto](https://ui.shadcn.com/docs) que shadcn/ui), por lo que puedes ajustar el marcado y alinear los estilos con tu sistema de diseño. +Una vez instalado un componente, puedes importarlo y usarlo como cualquier otro componente de React. Los archivos se agregan a tu proyecto (el mismo modelo de [código abierto](https://ui.shadcn.com/docs) que shadcn/ui), por lo que puedes ajustar el marcado y alinear los estilos con tu sistema de diseño. -Por ejemplo, después de instalar el componente [Insignia de Racha](https://ui.trophy.so/streak-badge), puedes componerlo en una página como la siguiente: +Por ejemplo, después de instalar el componente [Streak Badge](https://ui.trophy.so/streak-badge), puedes componerlo en una página como la siguiente: ```tsx "use client" @@ -57,4 +57,4 @@ export default function Page() { La ruta de importación predeterminada es `@/components/ui/`. Si tu `components.json` usa otro directorio o alias, actualiza la importación para que coincida. -Para props, variantes y formas de datos, usa la sección API de cada componente en su página de documentación—consulta [Todos los componentes](https://ui.trophy.so/docs/components) para ver la lista completa. \ No newline at end of file +Para props, variantes y estructuras de datos, consulta la sección API de cada componente en su página de documentación—ve [Todos los componentes](https://ui.trophy.so/docs/components) para la lista completa. \ No newline at end of file diff --git a/i18n.lock b/i18n.lock index ac00a21..12b8d5e 100644 --- a/i18n.lock +++ b/i18n.lock @@ -474,51 +474,55 @@ checksums: meta/og%3Adescription: 0c31ff8357910c4566c5444ba7ec2d9a content/0: 6e422a40926769a70977ec8760d8678a content/1: f8e9ee9e70d3979a06b50feb6cbdd428 - content/2: f41c18219e00643e5cdb8123c1752ee7 - content/3: 531d7a02d64d00b7421254744a2480b1 - content/4: cd99ee12ffd6f6bcf8a702a4909f1972 - content/5: 65e0af85cbb23ca135e56262618df8f1 - content/6: 7194831cc883248bdc9921d9167b24b7 + content/2: 8a3d931d7ee427303e7384903d387fb3 + content/3: d25e107a9b6556da0b92a9bd3a16db7f + content/4: 2d9541b4b7bf812e9354a256be7e3cb5 + content/5: bfbf13bcf33531496692c04b552f045f + content/6: 54e793c247d1770d085afed662461826 content/7: db8686b88c881fda7b9377ebdeefb72a - content/8: b5cacd3351b153d07d9bf73adc18c9a0 + content/8: 4bf86d4179ba8c3e150f6a768c1a970a content/9: cf4f06c5f179e0518445186762238fb0 content/10: f193a085ab60e0de7501771845fa064f - content/11: c8e22423db962390cb7356039c448e3e - content/12: b35b6dd260cd44c811622aed2c307fdd - content/13: ba903d08fe21291f7de673c8efdeb8a5 - content/14: 39869860e06375a53507816702e25894 - content/15: 673b1581199af42481abd365bc499274 - content/16: 7786c528b0fe8ddff35b7e1ea9132458 - content/17: b5df985278461b30f022adf43dc9751e - content/18: a65b3ee44e8f20c7fab2e89360391902 - content/19: 57ac8b56cbe1fe24ff5978a2e140a1f8 - content/20: 27718fbe349c9723c83a1bc0268f625d - content/21: 8cd8795d20c8b4ecb4adf2f1986cfe28 - content/22: 6c56ce6270996a6da36a63551094929f - content/23: 2de31ce64ae2ec0643e35b5d4f3794d7 - content/24: 0a020a22234cd5a8c4409f87dd74a4c4 - content/25: cdd33bc655b03bcba0b69e783340ec53 - content/26: 3d6c6c4f9855a8cf2f9d5f591b6c52df - content/27: f74b0afb330a295bb50103c7b2063e69 - content/28: 0048a761c5e2e672081222f23b20c716 - content/29: 3c5ab0cfa0a2b998885ff412132eb7ab - content/30: cd1c91d062a27881a798e92f1e239199 - content/31: 62bee6c8ee296a5be9c50b624827e7e7 - content/32: d06b3bc7b41c515df4deddc588e68420 - content/33: b02bef6aff19ed15bcf486b2974c2551 - content/34: ffe743c95b7b36efc1ff57bce471ad82 - content/35: 00b82b76758da5447270141518cdd41c - content/36: dffb591a41a53b1baaa93e10c333afef - content/37: 9a227656a512c5a79fc25ce848ebf163 - content/38: 67b49c25a88dfb4a006ae21c0e23ede7 - content/39: a69085aaa46c9b99c79ca3266d228e00 - content/40: f3931e5548f073249acc2b79e7972bf8 - content/41: 2e43465d0cd62f76e82df405620d29b6 - content/42: 2de31ce64ae2ec0643e35b5d4f3794d7 - content/43: c7293817039526172227474b477af24f - content/44: ff7d593434f7d8110b39a5b55748f428 - content/45: 10e8e9a59847ddd720c6d06b12c7b120 - content/46: 9799b973234bf2d10d5c971b267f55a5 + content/11: 835d46df4cebb477b5d37147fe440c66 + content/12: 37d39feebe142446862c62d4e2292d9f + content/13: 39869860e06375a53507816702e25894 + content/14: ace2c004fb3e18d453204b487a3d16fd + content/15: ccadd7bd657f717025e946820c2e1158 + content/16: 38ae530851b9afb8f23ee311f30b8b3c + content/17: 6c7389f75182f9f0ba5b750a995c2d67 + content/18: d9274464c3dbdf4c1c08ab088514f164 + content/19: daa5cbb8737a38b90527a7788ead9a97 + content/20: 937aa3b00548bc8626e53037686ba857 + content/21: 94588547d3a7d69971d57df60e230457 + content/22: 3ac0c1b0a1f290457d28d03f28f56131 + content/23: f4aeb29dcc8d706536a79cb63ed6c830 + content/24: 098e96a9d2c8bfda9912f7cc49f89f89 + content/25: b275fe43712dfcb47a40bc144c29ecd7 + content/26: 78ab5d549d17924195f6cf25799039f5 + content/27: bc941145fcdc49b8e46fad85bb780f4a + content/28: b85d953bba0f93289f78a87ed1e38d7f + content/29: cdd33bc655b03bcba0b69e783340ec53 + content/30: 3d6c6c4f9855a8cf2f9d5f591b6c52df + content/31: f74b0afb330a295bb50103c7b2063e69 + content/32: 0048a761c5e2e672081222f23b20c716 + content/33: 3c5ab0cfa0a2b998885ff412132eb7ab + content/34: cd1c91d062a27881a798e92f1e239199 + content/35: 62bee6c8ee296a5be9c50b624827e7e7 + content/36: d06b3bc7b41c515df4deddc588e68420 + content/37: b02bef6aff19ed15bcf486b2974c2551 + content/38: ffe743c95b7b36efc1ff57bce471ad82 + content/39: 00b82b76758da5447270141518cdd41c + content/40: dffb591a41a53b1baaa93e10c333afef + content/41: 9a227656a512c5a79fc25ce848ebf163 + content/42: 67b49c25a88dfb4a006ae21c0e23ede7 + content/43: a69085aaa46c9b99c79ca3266d228e00 + content/44: f3931e5548f073249acc2b79e7972bf8 + content/45: 2e43465d0cd62f76e82df405620d29b6 + content/46: 2de31ce64ae2ec0643e35b5d4f3794d7 + content/47: c7293817039526172227474b477af24f + content/48: ff7d593434f7d8110b39a5b55748f428 + content/49: 10e8e9a59847ddd720c6d06b12c7b120 + content/50: 9799b973234bf2d10d5c971b267f55a5 953868115d4c9e608173a3be973757d5: meta/title: f48ab602c5c8031afd2de550b2778bf0 meta/description: e25074e52204f7c87fd6279e356af78d @@ -3997,7 +4001,7 @@ checksums: f88bb06e37f2be82f58b7d21aea2fe12: meta/title: 2b3d02ff56b5f77b272637252681667c content/0: 1555401e851bd6d479e2e36e6687a71d - content/1: c4ef90329fd83d07df032f692a7050f6 + content/1: 7dff8a1393341082795e40b341bc05f4 content/2: c4c0244c4b4fcca018bbb9032318b161 content/3: c6db7efc321794d0986f60cc02c849cb content/4: 1b7803dd632c88fb68ac5771e43b1e67 @@ -6863,7 +6867,7 @@ checksums: content/10: c36fa0510464dd2605685ce280fd4d43 content/11: b3cbec3c00ea5370b81bad25e2a3b299 content/12: aa9a94c8a23d322f8db232da1c3dd000 - content/13: 2660992cb63cc07c3a75b1350b2dca78 + content/13: e54b571175703f64ad42af106715d60b content/14: e12165b2e66d44e72cd1469ba22a9046 content/15: 8c3834e1145d3ef724b09dc54f13acfa content/16: ef791342ea3753574b9dd35a1d5a65a4 @@ -6878,7 +6882,7 @@ checksums: meta/subtitle: 19b34186cda38b28f57ff47514306414 content/0: 67f3581dcb17b15abeb35cbe4276414b content/1: 8af5e8b96cb8fb79e029abcc2ee499e6 - content/2: 998380eb2ca953e360599d07a077e5ac + content/2: 31fc28440897c2d80ef471061cdf6f23 content/3: 2c2804834d2b5bb1864a4c0bead8a123 content/4: edf41ec1aa37f0ad9a0bb62ff915b439 content/5: 1912e21534893fae57c9123218cd7c2a @@ -6886,7 +6890,7 @@ checksums: content/7: 2d66ff151378efdf064b2c7065866e44 content/8: 4dbd81c88de2273aaa12ab8e0294765a content/9: 839bd034255a2a23d49c972f402d243e - content/10: 56bf739dd893db8de60e998aab963c1e + content/10: 9c758127c15a7a2c4d1666adf73f64fa content/11: 949a1ce6eeee49cbdf75166b63af7951 content/12: 894331d40abb73ee47109ed45fd1e3c5 content/13: 661e97346571e3f16d7b8aaf91b7be9f @@ -6895,41 +6899,37 @@ checksums: content/16: 9799b973234bf2d10d5c971b267f55a5 0900c9b2199247a6492b628a4be26fa9: meta/title: 70aaaea59e0186b1d4e2b175b26e4489 - meta/description: 0e9e0ce326e91df1c611a4626c153d69 + meta/description: b2e43ca765304c168f602bf72c22f0ce meta/subtitle: 588ce575ba06367cc778d1173092d46a meta/icon: f1a858d3c437c534103d95a3baac5387 content/0: b5f684a6be27a02965539795a839110d - content/1: e999933c9639a63c76d98da42e8d5c84 - content/2: 998380eb2ca953e360599d07a077e5ac - content/3: 34bc06e13023f063e414bece893eb029 - content/4: 9048ff005574830ea36d68c53074efdd - content/5: 820ff390b42931704ae81fbb95766b79 - content/6: b118ea2d7a06047926446fbeadfb6b7a - content/7: 6ee3cb0b4d92706090805881144d4bc7 - content/8: a7cc7fd0d7f4a4721ac555e930e4000d - content/9: e3f54f13da95a462283037d91efef43d - content/10: d78ff9b6e2c64fac9bbc99c1495b88b0 - content/11: 050838514f7d27366e758ea5bb7908f3 - content/12: d4223773ecc411ed5737f0aebd8aad4c - content/13: 6cc9f99481aa257403295d038d866e07 - content/14: ac9316d12802d40bfc8b837408556ac9 - content/15: ed2e41d05d1577a7e253ebbabea7da47 - content/16: 767ba153cc987948beff67c89a01b3a1 - content/17: a7254c770fd1175546824fda86a8b1c5 - content/18: f549c7d1fd2ccd020fbd874cf5d810a8 - content/19: 7459a559b0a8fcda7b8057706d198d47 - content/20: aabbde919ead607efb744bec81f374af - content/21: 3faca056dffc8c3fa2923fa487338f00 - content/22: 3304a33dfb626c6e2267c062e8956a9d - content/23: 0c9e0331453317905cbbdb10fdd9ee19 - content/24: 4c76a31f0259dc7749d33379a585822b - content/25: e1041a0f052cff7e363a92a13ccdfb46 - content/26: c3d474432986c8a6cd2d5c171d5d6b6b - content/27: a40e1779367f7b682a6167acd0bd7ed5 - content/28: 7b0c8f561f2d5e3655bf9251509a8946 - content/29: 4c7e32bd88a25ab0e1906200914d16d3 - content/30: 10e8e9a59847ddd720c6d06b12c7b120 - content/31: 9799b973234bf2d10d5c971b267f55a5 + content/1: d3ef58a43a41fc6d1a3d749a0154e9fc + content/2: 31fc28440897c2d80ef471061cdf6f23 + content/3: 4141c735e4cc5c98a1cba6c7cccf88ce + content/4: 34bc06e13023f063e414bece893eb029 + content/5: 9048ff005574830ea36d68c53074efdd + content/6: 02b4717b1266db3a50ec9e13fa3bce67 + content/7: 48463e1fa7f4fc656db039fd7295f4bc + content/8: 64a66a6ae62c79fa974c9216482e6daf + content/9: d78ff9b6e2c64fac9bbc99c1495b88b0 + content/10: 050838514f7d27366e758ea5bb7908f3 + content/11: d4223773ecc411ed5737f0aebd8aad4c + content/12: 127b11cdbd3d467915fa7285c027f421 + content/13: e942b77fa7c376eddddb4e69841bad06 + content/14: 7b14702e1d77029dd0d002d9c902c670 + content/15: 960da2c93dac9fb01d80317dfe66d756 + content/16: ed0ef8fc41bd6730342cfe616212f186 + content/17: 7459a559b0a8fcda7b8057706d198d47 + content/18: 3eb0a3b5f53d9dee47a3299dff392b4c + content/19: 3ec9cc178f86a4f6dc7c4977e9c91883 + content/20: 0c9e0331453317905cbbdb10fdd9ee19 + content/21: 4c76a31f0259dc7749d33379a585822b + content/22: e1041a0f052cff7e363a92a13ccdfb46 + content/23: 10d58ab107fa6b719695db67896361e7 + content/24: 7b0c8f561f2d5e3655bf9251509a8946 + content/25: 4c7e32bd88a25ab0e1906200914d16d3 + content/26: 10e8e9a59847ddd720c6d06b12c7b120 + content/27: 9799b973234bf2d10d5c971b267f55a5 9ffb422e2af788f84baa1b654718550a: meta/title: fd27a0028b8e4b31e39c77814f2bd47a meta/description: d259b3e6928b7d88c1dbb64c977c4a43 @@ -6983,7 +6983,7 @@ checksums: content/45: 971c4b437f7c3b6c1087bd063f86b13b content/46: 15e604d376406bf7724bd5fb32f3e16b content/47: 1df98519caec0282fe7b984ffd11efb9 - content/48: 29f0c3e3556fe7be2bf7419231b80f25 + content/48: 766538463ca4830371af694b963910d5 content/49: 10e8e9a59847ddd720c6d06b12c7b120 content/50: 9799b973234bf2d10d5c971b267f55a5 8526e0bfc63d38ab4ff24fc5b4332813: diff --git a/mcp/account-mcp-server/installation.mdx b/mcp/account-mcp-server/installation.mdx index a7d344d..ac6a5fc 100644 --- a/mcp/account-mcp-server/installation.mdx +++ b/mcp/account-mcp-server/installation.mdx @@ -29,7 +29,7 @@ Name this server clearly (for example `Trophy Account`) so it does not collide w - Name: `Trophy Account` - URL: `https://mcp.trophy.so/mcp` 4. Complete the OAuth login when prompted and select your Trophy organization. - 5. In chat, use the plus button to enable the Trophy Account connecto or type 'Using the Trophy Account MCP Server...'. + 5. In chat, use the plus button to enable the Trophy Account connector or type 'Using the Trophy Account MCP Server...'. Add the remote server: @@ -62,7 +62,7 @@ Name this server clearly (for example `Trophy Account`) so it does not collide w Reload Cursor if needed, then complete the OAuth login when prompted. - Custom MCP apps require a paid ChatGPT plan (Plus, Pro, Business, Enterprise, or Edu) with [Developer mode](https://platform.openai.com/docs/guides/developer-mode) enabled. + Custom MCP apps require a paid ChatGPT plan with [Developer mode](https://platform.openai.com/docs/guides/developer-mode) enabled. 1. In ChatGPT, open **Settings → Security and login** and turn on **Developer mode**. 2. In a chat, open the plus menu and create a developer-mode app for your remote MCP server. diff --git a/uikit/overview.mdx b/uikit/overview.mdx index 66b71d7..11c13ef 100644 --- a/uikit/overview.mdx +++ b/uikit/overview.mdx @@ -11,7 +11,7 @@ title: Gamification UI Kit /> -Trophy's Gamification UI Kit is a component library built on top of [shadcn/ui](https://ui.shadcn.com) that helps you build gamification experiences faster. It provides pre-built components for streaks, achievements, leaderboards, points, and more. +Trophy's [Gamification UI Kit](https://ui.trophy.so) is a component library built on top of [shadcn/ui](https://ui.shadcn.com) that helps you build gamification experiences faster. It provides pre-built components for streaks, achievements, leaderboards, points, and more. The UI Kit is designed to work with any gamification platform, but all props and data shapes are designed intentionally to work seamlessly with Trophy.