{% extends "settings_base.html" %}{% block title %}mcp{% endblock %}
{% block heading %}Connect over MCP{% endblock %}
{% block lede %}Point an agent at this workspace and it reads memory the way it reads
a filesystem — no export, no copy, no separate index.{% endblock %}

{% block settings %}
<div class="panel">
  <div class="panel-head"><h2>Install</h2></div>
  <div class="panel-body">
    <p class="muted" style="margin-top:0">Mint a token on the
      <a href="/console/settings/tokens">tokens page</a>, then:</p>
<pre>uv tool install opendiff        # once
claude mcp add opendiff -e OPENDIFF_TOKEN=&lt;your token&gt; -- \
  opendiff mcp --remote {{ api_base }}</pre>
  </div>
</div>

<div class="panel">
  <div class="panel-head"><h2>Tools</h2><span class="spacer"></span>
    <span class="stamp">8 read · 2 write</span></div>
  <div class="scroll"><table><thead><tr>
    <th>tool</th><th>what it does</th></tr></thead><tbody>
    <tr><td class="mono">ls</td><td class="muted">list a directory; <code>ls('')</code> gives the roots · paged</td></tr>
    <tr><td class="mono">cat</td><td class="muted">read one item, latest version or a pinned one</td></tr>
    <tr><td class="mono">stat</td><td class="muted">metadata for any path</td></tr>
    <tr><td class="mono">history</td><td class="muted">every version of one item, newest first</td></tr>
    <tr><td class="mono">find</td><td class="muted">full-text search with customer / type / date filters · paged</td></tr>
    <tr><td class="mono">read_many</td><td class="muted">batched read with partial success</td></tr>
    <tr><td class="mono">unrouted</td><td class="muted">the routing queue · paged</td></tr>
    <tr><td class="mono">sources</td><td class="muted">connector sync status</td></tr>
  </tbody></table></div>
  <div class="panel-body" style="border-top:1px solid var(--divider)">
    <p class="muted">Paged tools return <code>{items, next_cursor}</code>. A
      <code>next_cursor</code> that is not null means the result is incomplete — pass
      it back to get the next page.</p></div>
  <div class="panel-body" style="border-top:1px solid var(--divider)">
    <div class="row" style="margin-bottom:10px">
      <h3 style="margin:0">Writing back</h3>
      <span class="tag warn"><span class="dot"></span>temporary</span>
    </div>
    <p class="muted" style="max-width:64ch;margin-top:0">
      <code>publish_artifact</code> appends a derived-memory document — an account
      brief, a breach alert — to this workspace's <a href="/console">home page</a>,
      and <code>artifacts</code> lists what is already there. Publishing the same
      slug twice appends a version rather than overwriting, so a reviewer can always
      see what moved.</p>
    <p class="faint" style="font-size:13px;max-width:64ch;margin-bottom:0">
      This is a stand-in. The shape it is standing in for is a skill, published from
      MCP, running on a schedule over memory and writing its result here on its own.
      When that lands it calls the same endpoint, and the by-hand tool goes away.</p>
  </div>
</div>
{% endblock %}