Live on Product Hunt Intraface launched today. Less steering, more vacations. See the launch
Start for free

Connect Cursor to Intraface

Create a token in the Intraface app under Settings, then Agents, and export it as INTRAFACE_TOKEN. Add an intraface entry to .cursor/mcp.json or ~/.cursor/mcp.json with the URL https://app.intraface.cc/mcp and an Authorization header that reads the variable. Cursor's agent can then pull, edit and publish your team's boards.

Part of Integrations: how to connect each coding agent to a shared Intraface board.

Set it up

  1. Create a token in the Intraface app under Settings, then Agents, and copy it.

  2. Export it in your shell as INTRAFACE_TOKEN, then add Intraface to .cursor/mcp.json or ~/.cursor/mcp.json.

    {
      "mcpServers": {
        "intraface": {
          "url": "https://app.intraface.cc/mcp",
          "headers": {
            "Authorization": "Bearer ${env:INTRAFACE_TOKEN}"
          }
        }
      }
    }

    Using the Cursor CLI? Run cursor-agent mcp enable intraface once so it loads the server.

  3. Give Cursor a board link and let it work.

    Read <board link> and follow its collab.md.

    It pulls the board, edits it on your machine and publishes a new version.

Option A: the MCP server in mcp.json

  1. In the Intraface app, open Settings, then Agents, and create a token. Give it a label like "Cursor on my laptop" and copy it; it's shown once.
  2. Export it in your shell as INTRAFACE_TOKEN.
  3. Add Intraface to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json to have it everywhere:
{
  "mcpServers": {
    "intraface": {
      "url": "https://app.intraface.cc/mcp",
      "headers": {
        "Authorization": "Bearer ${env:INTRAFACE_TOKEN}"
      }
    }
  }
}

Cursor swaps in the variable when it starts the server, so the file never holds the secret and you can commit the project copy. Browser sign-in for Cursor isn't available yet, so the token is how it signs in.

Option B: the Cursor CLI

The Cursor CLI reads the same mcp.json. It waits for your approval before it loads a project server, so approve Intraface once and list its tools:

cursor-agent mcp enable intraface
cursor-agent mcp list-tools intraface

Newer installs name the command agent; use whichever your machine has.

What works once you're connected

Open Cursor's agent and paste: "Read and follow its collab.md." It reads the board's rules, pulls the files into your workspace, makes the change you asked for and publishes a new version. Ask it to go through the comments on the page and it can reply to each one or mark it resolved.

Your teammates' agents can work on the same board. Publishes go in one at a time, so nobody's work is overwritten. If a teammate changed the same file first, Cursor pulls the new version and redoes its edit.

Troubleshooting

  • Cursor asks before every tool call. Expand the tool name to read its arguments, then approve. In Auto-review run mode, tools you've pre-approved run without asking.
  • The server won't connect. Make sure INTRAFACE_TOKEN is set in the environment Cursor was started from, then restart the server. The Output panel (Cmd+Shift+U) has an "MCP Logs" view.
  • Pausing it. Find Intraface under Customize in the sidebar and switch it off.
  • Token deleted or lost. Create a new one under Settings, then Agents, and update the variable.

FAQ

Is it safe to commit .cursor/mcp.json with the Intraface entry in it?
Yes, as long as the header reads Bearer ${env:INTRAFACE_TOKEN} and not the token itself. Each teammate sets their own INTRAFACE_TOKEN, so every publish is recorded under the right person.
Why does the Cursor CLI say the Intraface server needs approval?
The Cursor CLI doesn't load MCP servers until you trust them. Run cursor-agent mcp enable intraface once, or start a session with --approve-mcps to approve every configured server.
How do I remove Cursor's access to my Intraface boards?
Delete its token in the Intraface app under Settings, then Agents. Make one token per machine, so you can cut off one laptop without touching the others.

Stop sending HTMLover Slack.

Create an account in a minute, connect your coding agent, and make your first board.