These instructions cover how to add Pastel to any AI agent. New to this? Start with Using the Pastel MCP server for an overview of what your agent will be able to do once it's connected.
You'll need: a Pastel account, and Pastel's MCP server URL: https://api.usepastel.com/mcp
Set it up
Copy Pastel's MCP server URL:
https://api.usepastel.com/mcpIn your agent's settings, add an MCP server using HTTP transport and OAuth authentication.
If your agent uses a JSON config file instead, paste the following into it:
{
"mcpServers": {
"pastel": {
"type": "http",
"url": "https://api.usepastel.com/mcp"
}
}
}
Complete the authorization flow to sign in to Pastel and approve access.
If you already have other servers in your config, add the "pastel" block alongside them inside the existing mcpServers object rather than replacing the whole file.
What to look for in your agent's settings
The wording varies, but the setting you want is usually under MCP, MCP servers, Connectors, Integrations or Plugins. A few things that catch people out:
Transport: choose HTTP, sometimes labelled Streamable HTTP or Remote. Pastel is a hosted server, so there's no command to run and nothing to install locally. If your agent asks for a command or arguments, you're on the wrong option.
Authentication: choose OAuth or "sign in with the provider". You don't need an API key, and Pastel doesn't issue one for this.
After connecting: start a new conversation. Most agents only pick up newly added tools at the start of a chat.
Check that it worked
Ask your agent:
List my Pastel canvases.
If it comes back with your canvases, you're connected.
Get the most out of it
If your AI agent is already sitting in your codebase, it can take a piece of feedback from end to end:
Take comment #14 on the pricing page canvas. Work out what's causing it, fix it, reply on the comment explaining what you changed, and mark it resolved.
Pastel sends your AI agent a canvas-specific investigation guide with every comment (which page to open, which element the comment is pinned to, where the screenshot is), so you don't need to explain any of that yourself.
You can also hand it a whole batch:
Go through the unresolved comments on the staging canvas, fix the ones that are clearly CSS issues, and leave the rest for me with a reply saying why.
Managing your connection
Every agent you've connected is listed in the MCP section of your Pastel profile settings, and can be disconnected there at any time.
Your agent only ever sees the canvases and comments that you can see, because it acts as you.
Using an agent we haven't covered?
We'd love to know. Tell us which agent you're using and we'll look at adding proper instructions for it. And if you hit a snag getting connected, get in touch and we'll help you work it out.