Skip to main content

Use Easel with AI agents

Connect Claude, ChatGPT, Cursor, or another MCP client to Easel to search the docs, deploy, and debug your projects.

The Easel MCP server lets AI agents search Easel's documentation and work with your projects: deploy, read build and request logs, manage environment variables and domains, and promote or roll back production. Its URL is:

https://mcp.easel.sh/mcp

The docs tools work without signing in. The first time an agent uses a tool that needs your account, your client opens Easel in the browser. You sign in, choose which workspaces it can use, and select Allow.

Connect a client

Each client adds the server by URL. Sign-in starts the first time you use an account tool.

  • Claude Code: install the Easel plugin, which adds the server and skills for deploying and debugging: claude plugin install easel --marketplace Easel-sh/plugin. Or add only the server: claude mcp add --transport http easel https://mcp.easel.sh/mcp.
  • Claude (claude.ai, Desktop, and mobile): in Settings, open Connectors, choose Add custom connector, and enter the URL.
  • ChatGPT: in Settings, open Apps and add the URL as a custom app in developer mode.
  • Cursor and other MCP clients: add an HTTP server with the URL to your client's MCP configuration, for example:
{
  "mcpServers": {
    "easel": { "url": "https://mcp.easel.sh/mcp" }
  }
}

What agents can do

The tools act only in the workspaces you choose when you sign in.

  • Docs: search pages and read them as Markdown.
  • Projects and usage: list projects, read their settings, create projects, and read usage.
  • Deployments: list deployments, read their status, build logs, and request logs, deploy files the agent wrote, promote a preview, roll back, or cancel a build.
  • Environment variables: list their names and set or delete them. Agents never see their values.
  • Domains: list, add, verify, and remove custom domains.

Agents can't manage API tokens or webhooks, change project settings, or delete projects. Deploying to production, promoting, rolling back, and removing things are marked as destructive, so your client asks you before it runs them.

To deploy a folder on your computer, ask the agent to use the Easel CLI (npx easel-sh deploy). The deploy_files tool is for small sites the agent writes in the conversation, up to 200 files and 2 MB.

Disconnect an app

You can see and disconnect the apps that can use a workspace.

  1. In the workspace, open Settings, then Connected Apps.
  2. Find the app and select Disconnect.

The app loses access to that workspace within 15 minutes. It keeps any other workspaces you gave it; disconnect it from each one to remove it entirely. Connect it again to choose different workspaces.