# Conecta una IA a tu proyecto

Configure MCP y una clave API para que un agente pueda leer o editar plantillas de proyecto.

Puede permitir que la IA inspeccione la estructura de la plantilla, explique las entradas o edite un diseño en su proyecto a través de **MCP (Beta)**. La conexión expone las herramientas Tembuilder a su aplicación de IA; una clave API del proyecto determina qué operaciones puede realizar.

## 1. Elige la conexión para tu tarea

Tembuilder proporciona dos conexiones MCP:

| Conexión | Propósito | Se requiere clave |
| --- | --- | --- |
| Documentos MCP · `/docs/mcp` | Buscar y leer documentación pública. | No. |
| Proyecto MCP · `/mcp` | Leer o editar plantillas de proyecto y Assets. | Sí. |

Si tiene preguntas sobre documentación, agregue un servidor en `https://<api-host>/docs/mcp` a su aplicación de IA sin una clave API. Utilice el host API que se muestra en la página **MCP (Beta)** de su proyecto. Los pasos siguientes configuran el Proyecto MCP.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Docs MCP lee la guía · El proyecto MCP funciona con plantillas">
<div class="sim-stage"><div class="ds-columns"><div class="sim-panel"><div class="ds-head"><strong>Documentos MCP</strong><div class="wf-actions"></div></div><div class="wf-rows"><div class="sim-focus"><span>/docs/mcp</span><small>Guías públicos</small></div><div class=""><span>Tecla API</span><small>No requerido</small></div></div></div><div class="sim-panel"><div class="ds-head"><strong>Proyecto MCP</strong><div class="wf-actions"></div></div><div class="wf-rows"><div class="sim-focus"><span>/mcp</span><small>Plantillas · Assets</small></div><div class=""><span>Tecla API</span><small>Alcance del proyecto</small></div></div></div></div></div>
<figcaption>Docs MCP lee la guía · El proyecto MCP funciona con plantillas</figcaption>
</figure>

## 2. Cree una clave API del proyecto

En el proyecto deseado, abra **Claves API** y cree una clave con los permisos adecuados:

- `mcp:read`: inspecciona plantillas, recursos y contexto de creación.
- Agregar `mcp:write`: permite crear, copiar y guardar mediante herramientas de escritura.

La clave determina a qué proyecto puede acceder la IA. Colóquelo en la configuración de conexión de su aplicación de IA; no es necesario que aparezca en el mensaje de edición.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Teclas API → mcp:read · agregar mcp:write para editar">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>Teclas API · MCP</strong><div class="wf-actions"></div></div><div class="wf-rows"><div class=""><span>mcp:leer</span><small>Leer contenido</small></div><div class="sim-focus"><span>mcp:escribir</span><small>Crear y guardar ediciones</small></div></div></div></div>
<figcaption>Teclas API → mcp:read · agregar mcp:write para editar</figcaption>
</figure>

## 3. Agregue el servidor a su aplicación de IA

Abra MCP o la configuración de conexiones de herramientas en su aplicación de IA. Utilice el punto final que se muestra en la página **MCP (Beta)** de su proyecto y un encabezado `ApiKey`. Configuración de ejemplo:

```json
{
  "mcpServers": {
    "tembuilder-project": {
      "url": "https://<api-host>/mcp",
      "headers": { "ApiKey": "<YOUR_API_KEY>" }
    }
  }
}
```

Este es un ejemplo de configuración HTTP remota; la ubicación de la configuración y el formato exacto dependen del cliente. El punto final utiliza el origen API, en lugar de la URL del panel. Los clientes que utilicen Autorización deben enviar `Authorization: ApiKey ...`, en lugar de Portador.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Página MCP → copie el punto final y configure la conexión">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>MCP · Proyecto</strong><div class="wf-actions"></div></div><div class="ds-code sim-focus"><code>https://&lt;api-host&gt;/mcp</code><code>ApiKey: &lt;YOUR_API_KEY&gt;</code></div></div></div>
<figcaption>Página MCP → copie el punto final y configure la conexión</figcaption>
</figure>

## 4. Comience leyendo una plantilla

Después de conectarse, intente esta solicitud:

> Lea las capacidades y enumere las plantillas en el proyecto. Para la plantilla que selecciono, explico su estructura y Parameters sin cambiar el contenido.

Una vez que AI haya encontrado la plantilla deseada, describa el cambio que desea y pídale que inspeccione una vista previa antes de guardar. Luego abra la plantilla en el editor para revisar su contenido y datos.

El proyecto MCP admite la creación, edición y vistas previas visuales de plantillas. Para usar los cambios en un PDF final, [guarde y publique en la aplicación](/docs/es/publishing/save-publish/), luego [ejecute un render](/docs/es/renders/preview-render/). MCP no tiene ninguna herramienta para publicar o retener trabajos de PDF.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="capacidades_espacio_trabajo → lista_plantilla → contexto_plantilla">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>MCP · herramientas</strong><div class="wf-actions"></div></div><div class="wf-tools"><div class="wf-tool"><small>01</small><code>workspace_capabilities</code><span>Capacidades de conexión</span></div><div class="wf-tool"><small>02</small><code>template_list</code><span>Buscar plantillas de proyectos</span></div><div class="wf-tool"><small>03</small><code>template_context</code><span>Revisión y estructura de la plantilla</span></div><div class="wf-tool sim-focus"><small>04</small><code>template_read</code><span>Fuentes o esquemas relevantes</span></div></div></div></div>
<figcaption>capacidades_espacio_trabajo → lista_plantilla → contexto_plantilla</figcaption>
</figure>