Connect an AI to your project

You can let AI inspect template structure, explain inputs, or edit a design in your project through MCP (Beta). The connection exposes Tembuilder tools to your AI application; a project API key determines which operations it can perform.

1. Choose the connection for your task

Tembuilder provides two MCP connections:

For documentation questions, add a server at https://<api-host>/docs/mcp to your AI application without an API key. Use the API host shown on your project’s MCP (Beta) page. The steps below configure Project MCP.

2. Create a project API key

In the intended project, open API Keys and create a key with the appropriate permissions:

• mcp:read: inspect templates, resources, and authoring context.
• Add mcp:write: allow creation, copying, and saving through writing tools.

The key determines which project AI can access. Put it in your AI application’s connection configuration; it does not need to appear in your editing prompt.

3. Add the server to your AI application

Open the MCP or tool connections settings in your AI application. Use the endpoint shown on your project’s MCP (Beta) page and an ApiKey header. Example configuration:

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

This is a remote HTTP configuration example; the settings location and exact format depend on the client. The endpoint uses the API origin, rather than the dashboard URL. Clients using Authorization must send Authorization: ApiKey ..., rather than Bearer.

4. Start by reading a template

After connecting, try this request:

Read the capabilities and list templates in the project. For the template I select, explain its structure and Parameters without changing content.

Once AI has found the intended template, describe the change you want and ask it to inspect a preview before saving. Then open the template in the editor to review its content and data.

Project MCP supports template creation, editing, and visual previews. To use the changes in a final PDF, save and publish in the app, then run a render. MCP has no tool for publication or retained PDF jobs.