assets.dev docs

MCP server

Connect an MCP client to assets.dev over Streamable HTTP and render from your agent.

The MCP endpoint is https://app.assets.dev/api/mcp. It speaks Streamable HTTP. Authenticate with an API key as a bearer token — the same key the REST API uses — or sign in with OAuth from connector UIs like claude.ai and ChatGPT. Need a key? See For agents.

Claude Code

Register the remote server from the CLI. Add --scope user to enable it in every project, then confirm with claude mcp list.

claude mcp add --transport http assets-dev https://app.assets.dev/api/mcp \  --header "Authorization: Bearer YOUR_API_KEY"

Requires an API key up front.

Claude (Desktop & claude.ai)

Settings → Connectors → Add custom connector, paste https://app.assets.dev/api/mcp, and sign in with your assets.dev account when prompted (OAuth). Prefer a static key? The beta Request headers field carries Authorization: Bearer YOUR_API_KEY, or use the Desktop-only mcp-remote bridge in claude_desktop_config.json:

{  "mcpServers": {    "assets-dev": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://app.assets.dev/api/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]    }  }}

OAuth sign-in — no key needed up front.

ChatGPT

Settings → Apps & Connectors → enable Developer mode → add an app with the server URL below. Sign in with OAuth when prompted, or pick the API-key auth mode and paste your key.

https://app.assets.dev/api/mcp

OAuth sign-in — no key needed up front.

Cursor

Add the server to ~/.cursor/mcp.json (or a project's .cursor/mcp.json):

{  "mcpServers": {    "assets-dev": {      "url": "https://app.assets.dev/api/mcp",      "headers": { "Authorization": "Bearer YOUR_API_KEY" }    }  }}

Requires an API key up front.

VS Code

Add .vscode/mcp.json with the secure inputs pattern so the key is prompted at connect time and never stored in the file:

{  "inputs": [    { "type": "promptString", "id": "assets-dev-key", "description": "assets.dev API key", "password": true }  ],  "servers": {    "assets-dev": {      "type": "http",      "url": "https://app.assets.dev/api/mcp",      "headers": { "Authorization": "Bearer ${input:assets-dev-key}" }    }  }}

Requires an API key up front.

OpenAI Codex

Add the server to ~/.codex/config.toml and export ASSETS_DEV_API_KEY in your environment:

[mcp_servers.assets_dev]url = "https://app.assets.dev/api/mcp"bearer_token_env_var = "ASSETS_DEV_API_KEY"

Requires an API key up front.

OpenCode

Add the server to opencode.json and export ASSETS_DEV_API_KEY in your environment:

{  "$schema": "https://opencode.ai/config.json",  "mcp": {    "assets-dev": {      "type": "remote",      "url": "https://app.assets.dev/api/mcp",      "enabled": true,      "headers": { "Authorization": "Bearer {env:ASSETS_DEV_API_KEY}" }    }  }}

Requires an API key up front.

Manus

Settings → Connectors → Add connectors → Custom MCP → Direct configuration. Name it assets.dev, paste the URL below, and set the Bearer token to your API key.

https://app.assets.dev/api/mcp

Requires an API key up front.

Two ways to authenticate

Connector UIs (claude.ai, Claude Desktop, ChatGPT, Manus) can sign in with OAuth: add the server URL and authenticate with your assets.dev account when prompted. Everything else takes the bearer key in a header, per the snippets above. The full tool catalog is in For agents.

On this page