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

Connect OpenCode to Intraface

Add a remote server named intraface with the URL https://app.intraface.cc/mcp under the mcp key in opencode.json. Then run opencode mcp auth intraface, sign in to Intraface in your browser and click Allow. After that OpenCode can pull a shared board, change the files and publish a new version for your team.

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

Set it up

  1. Add Intraface under the mcp key in opencode.json.

    {
      "$schema": "https://opencode.ai/config.json",
      "mcp": {
        "intraface": {
          "type": "remote",
          "url": "https://app.intraface.cc/mcp"
        }
      }
    }
  2. Start the sign-in. Your browser opens on app.intraface.cc.

    opencode mcp auth intraface
  3. Sign in and click Allow.

  4. Give OpenCode 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: a remote MCP server in opencode.json

OpenCode has no add command for remote servers; you describe the server in opencode.json. Put this under the mcp key:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "intraface": {
      "type": "remote",
      "url": "https://app.intraface.cc/mcp"
    }
  }
}

Then sign in:

opencode mcp auth intraface

Your browser opens on app.intraface.cc. Sign in and click Allow. If you skip this step, OpenCode starts the same sign-in the first time it uses a board.

Option B: a token in a header

For a machine without a browser, use an Intraface token. Create it in the Intraface app under Settings, then Agents, and copy it when it's shown. Then switch off the browser sign-in for this entry and read the token from your environment with OpenCode's {env:...} syntax:

{
  "mcp": {
    "intraface": {
      "type": "remote",
      "url": "https://app.intraface.cc/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:INTRAFACE_TOKEN}"
      }
    }
  }
}

Set INTRAFACE_TOKEN in the shell that launches OpenCode.

What works once you're connected

Start OpenCode off with "Read and follow its collab.md." The Intraface tools sit next to its built-in ones: it reads the board's house rules and comments, pulls the files of the latest version, changes them with its own edit tools and publishes. It can also reply to the comments people leave on the page.

Publishes go in one at a time, so two agents can't overwrite each other. If a teammate changed the same file first, OpenCode pulls the new version and redoes its edit.

Troubleshooting

  • Still "needs authentication". Run opencode mcp auth intraface again and finish the browser step.
  • The sign-in doesn't start. Run opencode mcp debug intraface. It shows the sign-in status and tests the connection.
  • A large board times out. Add "timeout": 60000 to the entry.
  • Too much context used. The tools section of the config can switch a server's tools off when you don't need them.

FAQ

Why does OpenCode list Intraface as needs authentication?
It hasn't signed in yet. Run opencode mcp auth intraface, or ask OpenCode to use a board, and approve the sign-in in your browser.
Can I commit OpenCode's Intraface entry to a repository?
Yes. The entry holds only the server URL, so it's safe in a project opencode.json. Each teammate signs in with their own Intraface account the first time they use it.
How do I sign OpenCode out of Intraface?
Run opencode mcp logout intraface to drop the stored sign-in on your machine. To end it everywhere, revoke the agent in the Intraface app under Settings, then Agents.

Stop sending HTMLover Slack.

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