> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tess.im/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom MCP

> Conecta tus propios servidores MCP remotos a Tess para que chats y agentes usen esas herramientas junto con los conectores nativos.

Custom MCP hace que Tess actúe como **cliente MCP**. Registras un servidor remoto (Attio, Gleap, Volt, Supabase, una herramienta interna o cualquier endpoint MCP Streamable HTTP), Tess descubre sus herramientas y esas herramientas quedan disponibles en el chat y en los agentes — junto con los [Conectores](/es/connectors) nativos.

Es el sentido inverso del [Servidor MCP de Tess](/es/api-mcp), que expone Tess *hacia* Claude, Cursor y otros clientes MCP.

<CardGroup cols={2}>
  <Card title="Servidor MCP de Tess" icon="cloud" href="/es/api-mcp">
    Usa agentes, archivos y memorias de Tess desde Claude, Cursor, Codex o cualquier cliente MCP. Endpoint: `https://mcp.tess.im`.
  </Card>

  <Card title="Custom MCP" icon="plug">
    Trae un servidor MCP *externo* a Tess. Tus chats y agentes llaman a las herramientas de ese servidor con tus credenciales.
  </Card>
</CardGroup>

<Info>
  Custom MCP está disponible cuando la función del workspace está habilitada. Las Apps nativas (Gmail, Slack, Notion y el resto del catálogo) siguen en [Conectores](/es/connectors) — usa Custom MCP para servidores que no están en ese catálogo.
</Info>

## Antes de empezar

Necesitas:

* Un **endpoint MCP remoto** con **Streamable HTTP** (no un proceso local `npx`/stdio).
* Permiso para **crear servidores MCP personales** (o permiso de gobernanza, si vas a compartirlo con el workspace).
* Las credenciales que el servidor espera: **OAuth** (inicio de sesión interactivo) o **token estático** (Bearer, API key o encabezados personalizados).

<Warning>
  Mantén las cuentas personales como personales. Un MCP de WhatsApp, correo o CRM ligado a *tu* identidad debe permanecer **personal**. Compartirlo con el workspace permite que otros miembros se inscriban y llamen esas herramientas. Consulta [Compartir y permisos](/es/mcp-sharing-permissions).
</Warning>

## Añadir un servidor Custom MCP

<Steps>
  <Step title="Abre Conectores">
    En el chat, haz clic en **+** → **Connectors** → **Add connectors** y abre la franja **Custom MCP**. También puedes gestionar servidores en **Ajustes → MCP Plugins**.
  </Step>

  <Step title="Introduce el endpoint">
    Pon un nombre al servidor y pega la URL distante (por ejemplo `https://mcp.attio.com/mcp` o `https://mcp.voltchat.com/mcp`). Tess solo acepta endpoints HTTP(S) remotos permitidos.
  </Step>

  <Step title="Elige cómo autenticarte">
    * **OAuth** — Tess descubre los metadatos de auth y abre un popup para que autorices *tu* cuenta. Permite ventanas emergentes para terminar el flujo.
    * **Bearer / API key / encabezado** — pega el token que Tess debe enviar en cada llamada a ese servidor.
  </Step>

  <Step title="Guarda y después conecta">
    Tras guardar un servidor OAuth, haz clic en **Connect** y completa el login del proveedor. Tess sincroniza entonces la lista de herramientas. No habilites el servidor en el chat hasta que la conexión tenga éxito — un servidor OAuth sin token conectado no puede ejecutarse.
  </Step>

  <Step title="Activa las herramientas que quieras">
    Cada herramienta se puede encender o apagar **para ti**. Desactivar una herramienta nunca cambia la selección de otro miembro. En el chat, selecciona el MCP en Conectores como cualquier otra app para que el agente pueda llamarlo.
  </Step>
</Steps>

Los servidores nuevos son **personales** por defecto. Compartirlos con el workspace es una acción separada y explícita, y requiere permiso de gobernanza.

## Modelos de autenticación

| Cómo autentica el MCP             | Qué almacena Tess           | A quién pertenece                                                                        |
| --------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------- |
| **OAuth**                         | Token conectado por usuario | Siempre **tu** cuenta, aunque el servidor esté compartido                                |
| **Bearer / API key / encabezado** | Credencial estática cifrada | Personales: el creador. Compartidos: credencial del workspace definida por un gobernador |

<Tip>
  Prefiere OAuth cuando el proveedor lo ofrezca (Attio, Meta Ads y muchos MCP alojados). Cada miembro que use un MCP OAuth compartido debe hacer clic en **Connect** e iniciar sesión con su propia cuenta. Tess nunca reutiliza el token OAuth de otra persona.
</Tip>

## Uso en el chat y en los agentes

Con el servidor conectado y habilitado para ti:

* **Chat** — selecciónalo en Conectores (el mismo control que Gmail o Slack). Si no está seleccionado, Tess no inyecta las herramientas en ese turno.
* **Agent Studio** — añádelo a la política de conectores del agente, o deja **User decision** activado para que cada usuario final elija en el momento.
* **Chips de herramientas** — activa o desactiva capacidades individuales sin eliminar el servidor.

<Note>
  Un MCP compartido en el que no has hecho opt-in no aparece en tu chat. Actívalo primero en MCP Plugins o en el modal de Conectores. Detalles: [Compartir y permisos](/es/mcp-sharing-permissions).
</Note>

## Qué hace Tess con el servidor

1. Descubre herramientas (y recursos, cuando el servidor los expone) por MCP.
2. Las convierte al mismo formato de las herramientas nativas de Tess.
3. Inyecta solo las herramientas **que tú** activaste, y solo si el servidor es conectable (credencial estática válida o token OAuth conectado).
4. Llama al servidor remoto con **tu** credencial. Las ejecuciones siguen créditos y permisos del workspace.

Si no hay credencial usable para ti, Tess oculta el servidor del descubrimiento de herramientas en lugar de llamarlo sin autenticación.

## Relacionado

<CardGroup cols={2}>
  <Card title="Compartir y permisos" icon="shield-check" href="/es/mcp-sharing-permissions">
    Servidores personales vs compartidos, opt-in y quién puede crear, compartir o eliminar.
  </Card>

  <Card title="Buenas prácticas" icon="list-check" href="/es/mcp-best-practices">
    Descubrimiento OAuth, solución de problemas y cómo evitar que herramientas personales se filtren en el workspace.
  </Card>
</CardGroup>