---
title: "Crea una app de Matchai"
description: "Registra la app que los profesionales conectan con Conectar con Matchai: nombre, logo, sitio web, URL de redirección, ID y secreto, modo de prueba y quién paga."
last_updated: "2026-10-21"
lang: "es"
status: "coming-soon"
canonical: "https://matchai.co/docs/es/developers/authentication/create-a-matchai-app"
---

# Crea una app de Matchai

> Registra la app que los profesionales conectan con Conectar con Matchai: nombre, logo, sitio web, URL de redirección, ID y secreto, modo de prueba y quién paga.

**Próximamente. Esto se documenta antes del lanzamiento para que puedas planificar tu integración; todavía no está disponible.**

Source: https://matchai.co/docs/es/developers/authentication/create-a-matchai-app

Una **app de Matchai** es la forma en que tu producto aparece en Matchai. Cuando un profesional conecta su cuenta a tu creador de sitios web, a tu CRM o a tu asistente, la conecta a tu app de Matchai: esta lleva tu nombre y tu logo en la página de autorización, aparece después en su página Conectores y contiene el ID de cliente y el secreto de cliente que tu código usa para ejecutar el [flujo OAuth](https://matchai.co/docs/es/developers/authentication/connect-with-matchai).

## ¿Necesitas una? [#do-you-need-one]

| Estás creando | Necesitas |
|---|---|
| Un script o una herramienta para tu propia cuenta | Una [clave de API](https://matchai.co/docs/es/developers/authentication/api-keys). Ninguna app. |
| Un producto que usan otros profesionales, como un creador de sitios web, un CRM o la app de un socio | Una app de Matchai y [Conectar con Matchai](https://matchai.co/docs/es/developers/authentication/connect-with-matchai) |
| Leer lo que los profesionales ya publicaron | Nada. Los [recursos públicos](https://matchai.co/docs/es/developers#what-is-live-today) no necesitan clave ni app. |

Los clientes MCP como Claude y ChatGPT no necesitan una app que registres tú: se registran solos cuando un profesional agrega Matchai. Consulta [Clientes MCP](https://matchai.co/docs/es/developers/authentication/connect-with-matchai#mcp-clients-and-dynamic-client-registration).

## Registra tu app [#register-your-app]

<Steps>
<Step>

Abre **Configuración → Conectores** en Matchai, despliega **Avanzado (para desarrolladores)** y elige **Crear una app de Matchai**.

</Step>
<Step>

Completa los datos de la app:

<TypeTable
  type={{
    name: { type: 'string', required: true, description: 'El nombre que ven los profesionales en la página de autorización y en su página Conectores. Usa el nombre de tu producto, tal como lo conocen tus clientes.' },
    logo: { type: 'image', required: true, description: 'Se muestra junto al nombre. Una imagen cuadrada funciona mejor.' },
    website: { type: 'URL', required: true, description: 'El sitio donde un profesional puede conocer tu producto. Se muestra en la página de autorización.' },
    'redirect URLs': { type: 'URL[]', required: true, description: 'Cada dirección en la que tu app recibe la devolución de llamada de OAuth. Matchai solo redirige a una dirección que registraste, con coincidencia exacta.' },
  }}
/>

</Step>
<Step>

Guarda la app. Matchai te da un **ID de cliente** y un **secreto de cliente**.

</Step>
<Step>

Guarda el secreto en tu servidor, en un gestor de secretos o en una variable de entorno. Tu app ya está lista para iniciar el [flujo de conexión](https://matchai.co/docs/es/developers/authentication/connect-with-matchai).

</Step>
</Steps>

## ID de cliente y secreto de cliente [#client-id-and-client-secret]

| | Qué es | Dónde va |
|---|---|---|
| ID de cliente | Identifica tu app. Aparece en la dirección de la página de autorización, así que no es secreto. | En la redirección a Matchai |
| Secreto de cliente | Demuestra que una solicitud viene realmente de tu app. | Solo en las llamadas del lado del servidor al endpoint de tokens. Nunca en código de navegador ni en una app móvil. |

Trata el secreto como una contraseña: mantenlo fuera de los repositorios, los registros y las capturas de pantalla.

## URL de redirección [#redirect-urls]

Después de que el profesional responde en la página de autorización, Matchai envía su navegador de vuelta a una de tus URL de redirección. Para que ese traspaso sea seguro:

- Registra cada dirección que usa tu app, incluida la que usas en tu propia computadora mientras desarrollas.
- Matchai sigue OAuth 2.1: una dirección de redirección debe coincidir exactamente con una registrada y debe usar `https`. La excepción es una dirección de loopback como `http://localhost:3000/matchai/callback`, que se acepta mientras desarrollas.
- Nunca aceptes la dirección de redirección desde un parámetro de la solicitud que cualquiera podría cambiar.

## Modo de prueba [#test-mode]

Puedes crear y probar antes de que se conecte ningún cliente, sin costo. Una app que está conectada solo a la cuenta de su propio desarrollador está en **modo de prueba**:

- **No se factura.** Conecta tu propia cuenta de Matchai a tu propia app tantas veces como quieras.
- **Está marcada.** `GET /v1/me/connection` devuelve `test_mode: true`, y los eventos que recibe tu endpoint de webhooks llevan `test_mode: true`.
- **Es una conexión real.** Pasas por la misma página de autorización y obtienes el mismo tipo de tokens, alcances y aprobaciones que obtendrán tus clientes, así que puedes construir el flujo completo antes del lanzamiento.

Cuando otro profesional conecta tu app, esa conexión es real y se factura como se describe en [quién paga](#who-pays).

## Quién paga [#who-pays]

Conectar una app a una cuenta es un conector de Matchai de pago, el mismo tipo de conexión que Claude o ChatGPT en la página Conectores. La unidad de facturación es **una cuenta de Matchai conectada a una app**. Una app que da servicio a tres profesionales tiene tres conexiones, sin importar cuántos tokens, webhooks o solicitudes haya detrás.

Cada app de Matchai tiene un ajuste **quién paga**:

| Ajuste | Lo que ve el profesional | A quién se le factura |
|---|---|---|
| **Pagado por el usuario** (el predeterminado) | La página de autorización dice que la conexión se agrega a su factura de Matchai. | Al profesional |
| **Pagado por el socio** | La página de autorización dice que la conexión está incluida con tu producto. | A ti, como socio |

El modo pagado por el socio es para socios verificados que tienen un acuerdo con Matchai. Si quieres pagar las conexiones de tus clientes, [contacta al soporte de Matchai](https://matchai.co/support) para conversarlo. Hasta entonces, tu app es pagada por el usuario, y la página de autorización se lo dice a cada profesional antes de que presione **Permitir**.

Matchai marca las apps cuyo editor verificó. `GET /v1/me/connection` devuelve `app.verified`.

Leer información pública, como los anuncios publicados de un profesional, nunca necesita una conexión y es gratis.

<Callout title="Por qué la página de autorización dice quién paga">
Un profesional nunca debería llevarse una sorpresa con un cargo. Ve la consecuencia de precio de conectar tu app en el momento en que decide, junto a lo que la app puede hacer, y puede desconectarla en cualquier momento.
</Callout>

## Qué sigue [#what-happens-next]

<Cards>
  <Card title="Conectar con Matchai" href="https://matchai.co/docs/es/developers/authentication/connect-with-matchai">
    Envía a un profesional a la página de autorización e intercambia el código por tokens.
  </Card>
  <Card title="Autenticación" href="https://matchai.co/docs/es/developers/authentication">
    Alcances, acciones finales y límites de energía.
  </Card>
  <Card title="Webhooks" href="https://matchai.co/docs/es/developers/webhooks">
    Entérate de los prospectos y las reservas de las cuentas que se conectan.
  </Card>
</Cards>

## Sitemap

- [Todas las páginas de la documentación de Matchai](https://matchai.co/docs/sitemap.md)
- [llms.txt](https://matchai.co/docs/es/llms.txt)