Skip to content
Charming Docs
Esc
navigateopen⌘Jpreview
On this page

Set up Cursor

Connect Cursor with one prompt, or add Charming as a remote MCP server.

Choose a setup path

Paste one prompt. This is the fastest path. Cursor connects through Charming’s HTTP API and asks you to approve the connection.

Add the MCP server. Paste one URL into Cursor’s MCP settings to keep the Charming tools ready in Cursor.

Both paths build the same apps. You only need one.

Connect with one prompt

Paste this into Cursor:

Connect me to Charming and help me build my first app. Read
https://charm.ing/docs/clients/index.md first.
Use Charming's HTTP API. Ask before starting account pairing, wait for
me to approve it, then read https://charm.ing/docs/build-http.md and
ask me what I want to build.

Cursor chat with the Charming setup prompt ready to send.

Cursor shows a pairing link and a short code. Open the link, enter the code if asked, and approve the connection.

Cursor showing a Charming pairing link and a redacted code.

Charming confirming that the agent is connected.

Add the MCP server

1. Open the MCP settings

In Cursor, open Customize, choose MCPs, then click New MCP Server.

Cursor sidebar with Customize selected.

Cursor MCP settings with New MCP Server ready to select.

2. Paste the configuration

Cursor opens mcp.json. Paste this configuration:

{
  "mcpServers": {
    "charming": {
      "url": "https://charm.ing/mcp"
    }
  }
}

Cursor mcp.json with the Charming server URL.

If the file already has other servers, add the "charming" entry inside the existing "mcpServers" object. Keep the rest of the file.

3. Sign in

Save the file. Back in Customize → MCPs, click Authenticate beside Charming.

Cursor showing that Charming needs authentication.

Sign in to Charming in the browser, approve the connection, and return to Cursor.

Charming sign-in page.

4. Check the connection

Charming should now show as connected. Ask Cursor to build an app; it will return a browser link.

Project and global configuration

Cursor reads global MCP servers from ~/.cursor/mcp.json. Use that file to make Charming available in every project.

For one project, put the same configuration in .cursor/mcp.json inside the project. The remote server uses browser sign-in, so the file needs no API key.

See Cursor’s MCP guide for project and global server configuration.

Troubleshooting

What you see What to try
Charming shows as disconnected Toggle the server off and on, or restart Cursor.
The tools list is empty Finish browser sign-in, then reconnect the server.
Connection refused or 404 Use https://charm.ing/mcp, with no api. prefix and no trailing slash.
Cursor reports a JSON error Remove a trailing comma and check that the file has one "mcpServers" key.
The app does not appear inside Cursor Open the Charming URL returned by the tool. Cursor uses the browser fallback.

Was this page helpful?