Custom app (MCP SDK)
- Advanced
- 4 steps
Connect your own app to Drento with the official MCP SDK.
Build your own client Any app built on the official MCP SDK can connect to Drento. For your own scripts, a token is the quickest start. For an app other people use, use the SDK's OAuth support so each person signs in to Drento and approves access.
Before you start
Check these first.
A Drento account
Any Drento account can connect and read its projects. Creating blueprints, designs, logos and optional wireframes uses your plan's credits, so it needs an active plan: Starter, Creator or Studio.
An MCP SDK with Streamable HTTP
Drento accepts MCP protocol versions 2025-11-25, 2025-06-18 and 2025-03-26 over Streamable HTTP. The older SSE-only transport is not supported.
Steps
Install the SDK
Run
npm install @modelcontextprotocol/sdk, or add the official MCP SDK for your language.Connect over Streamable HTTP
Create a StreamableHTTPClientTransport that points at
https://mcp.drento.app/mcp.Authenticate
For your own scripts, send a token in the Authorization header. For apps other people use, give the transport an OAuth provider so each person signs in to Drento and approves access.
List and call tools
Call listTools() to see what the connection may use, then callTool() with a name from the tools reference, such as
drento_list_projects.
Server settings
A small client that connects with a token and lists your projects.
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
const transport = new StreamableHTTPClientTransport(new URL("https://mcp.drento.app/mcp"), {
requestInit: {
headers: { Authorization: `Bearer ${process.env.DRENTO_TOKEN}` },
},
})
const client = new Client({ name: "my-app", version: "1.0.0" })
await client.connect(transport)
const { tools } = await client.listTools()
const projects = await client.callTool({ name: "drento_list_projects", arguments: {} })These values are the same for every AI tool.
- Server URL
https://mcp.drento.app/mcp- HTTPS, with no trailing slash
- Transport
Streamable HTTP- The only transport Drento supports
- MCP protocol versions
2025-11-252025-06-182025-03-26- Your AI tool picks one when it connects
- Sign-in
OAuth 2.1, or Bearer <token>- Most AI tools handle sign-in for you. Scripts send a personal access token.
To disconnect an AI tool or delete a token, open Connections in the Drento sidebar.
Drento's approval page lists these. Nothing is granted until you approve.
projects:readRead-onlyprojects:writeCan deleteprojects:deleteCan deleteblueprint:writeMakes changeswireframes:writeMakes changesdesigns:generateMakes changesdesign-system:writeMakes changeslogos:generateMakes changeslogos:reviewRead-onlyadvisor:chatMakes changesaccount:readRead-onlygenerations:readRead-only
Having trouble?
Most problems come from one of three things: an AI tool that is out of date, a permission you did not approve, or a connection that was removed in Connections. The tools reference lists the permission each tool needs.
Open the tools reference