Maple Harness home

Maple Harness 2.6.2 released! What's new in 2.6.2

Single userTeams & hubs

One person, one machine: the agent, the proxy and your own usage.

Several people, from one shared proxy up to a hub of hubs.

Give other tools this project's knowledge #

On this page
  1. In plain words
  2. Claude Code
  3. OpenCode
  4. Another Maple Harness
  5. Using MCP servers from the agent

maple-harness mcp serve lets any tool that speaks MCP (Claude Code, OpenCode, another Maple Harness) read this project's notes and code map, the same ones the agent uses.

Build the index once from the project directory:

maple-harness graph reindex

Then connect a tool. A client normally launches the server itself.

In plain words #

  • What it is. Other tools (Claude Code, OpenCode, another Maple) can read this project's memory notes and code map, the ones Maple builds as it works.
  • Why you want it. Each tool starts already knowing your project's structure, instead of reading it again.
  • What to do. maple-harness graph reindex once in the project, then add the server to your tool with the line below. There is no setup page step.

Claude Code #

claude mcp add maple-knowledge -- maple-harness mcp serve

or in the project's .mcp.json:

{
  "mcpServers": {
    "maple-knowledge": {
      "command": "maple-harness",
      "args": ["mcp", "serve"]
    }
  }
}

Add "--read-only" to the arguments to withhold the tools that write notes.

OpenCode #

In opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "maple-knowledge": {
      "type": "local",
      "command": ["maple-harness", "mcp", "serve"],
      "enabled": true
    }
  }
}

Another Maple Harness #

In config.yaml:

harness:
  mcp_servers:
    - name: knowledge
      command: maple-harness
      args: ["mcp", "serve", "--project", "/path/to/other/project"]

Using MCP servers from the agent #

The agent can use MCP servers too, from the harness.mcp_servers list or a project's .mcp.json. Their tools ask for approval like any other tool. A server that runs as a program on your machine runs with your permissions, so add only servers you trust. A server reached over the network needs https unless it is on this machine.

A project's own .mcp.json is not something you configured yourself, so the first time one is found for a project you have not seen before, Maple Harness asks before starting the server it names (or, without a terminal to ask on, skips it and says so). Once approved, it starts normally; editing the file afterwards asks again. harness.mcp_servers in your own config.yaml is unaffected — it always runs. See maple-harness trust --help.

The project is the directory the server is launched in, or --project DIR.

Related: the settings for the MCP servers the agent uses are in Harness settings; for scripts and editor plugins that drive a whole session, see Drive it from another program.

Made with ❤️ by Kinn Coelho Juliao in Ottawa, eh — fuelled by double-doubles, bud. 🍁