Skip to main content
The Kombai connector is a remote MCP server that lets apps such as Claude, ChatGPT, and Figma run Kombai’s taste agent from a chat. Describe what you’re designing, and Kombai writes distinct design directions for it, each with a concept, layout, palette, typography, motion, and links to stock photos and AI images.
The connector writes design directions. It doesn’t build designs on a Kombai canvas. To design on a canvas from a coding agent such as Claude Code, Codex, or Cursor, install the Kombai plugin.

Before you begin

You need an app that supports remote MCP servers with OAuth sign-in, and a Kombai account with credits. You can create an account when you connect, and new accounts start with free credits. See Credits. The connector’s URL is:

Add the connector

Works on claude.ai and in the Claude desktop and mobile apps. On the Free plan, Claude allows one custom connector.
  1. Go to Customize > Connectors, select + Add, then Add custom connector.
  2. Enter Kombai as the name and https://agent.kombai.com/mcp as the URL, then select Continue.
  3. Keep the authentication settings Claude detects, select Continue and then Add, and sign in.
On Team and Enterprise, an Owner adds the connector first in Organization settings > Connectors (Add > Custom > Web), and each member then selects Connect on Kombai in Customize > Connectors.To use it in a chat, select + in the message box, choose Connectors, and turn Kombai on.
To check the connection, ask your app how many Kombai credits you have. It answers with your account’s email, plan, and credits left.

Sign in

Your app opens Kombai’s sign-in page in your browser. Sign in or create an account, approve the connection, and your app returns to the chat connected. It never sees your Kombai password. If you sign up with an email and password, confirm your email. Confirming in the same browser finishes the connection. If you confirm on another device, go back to the tab that says Email confirmed and select Continue here. To disconnect, remove the Kombai connector in your app.

Ask for design directions

Mention Kombai and describe what you’re designing:
A good brief names the product and the page or screen, who it’s for, what it must say or do, the feel you want, and any brand colors, fonts, or constraints to keep. A brief can be up to 8,000 characters. Your app starts a taste run and gives you a link to its taste card. The run takes a few minutes. When it finishes, apps that show MCP Apps, such as Claude, show the directions as taste cards in the chat; other apps summarize them and give you the link. Ask for a direction by number to get it in full. You can ask for 1 to 4 directions (the default is 2), and for stock photos only, with no AI-generated images. Each run spends credits, and more directions and AI images spend more. The taste card link opens only for the Kombai account that started the run, and Kombai keeps each run for 30 days.

Connector tools

Your app calls these tools for you.

Data and privacy

Kombai receives only the brief your app writes for each run and the options it picks, not the rest of your conversation. Your app signs in with OAuth, and runs belong to your Kombai account and spend its credits.

Troubleshooting

Open the plan page link your app gives you to get more credits, or see Credits for when free credits renew. On a team, your Team Admin adds credits.
A Billing Admin can’t spend the team’s credits. Connect with a Team Admin or Team Member account. See Roles and permissions.
Ask your app to try again in a minute.
Kombai doesn’t run taste for some addresses, such as disposable ones. Disconnect and connect again with an account that uses another email address, or contact support@kombai.com.
The connection request expired while you were signing in. Go back to your app and connect again. You’re already signed in, so it goes straight through.
Your app doesn’t show MCP Apps in this chat. Open the taste card link it gives you instead.
A chat opened before you re-added the connector still points at the old one. Reload the chat or start a new one.