theseus.x: Claude connector on the extensions and developer pages

The connector ships off by default with the next Theseus release; users
need the setup steps (claude mcp add with the panel's token) and a plain
account of what it can and cannot do before turning it on.
This commit is contained in:
Dev 2026-10-23 18:08:05 +03:00
parent c7ceaa6c18
commit 70a71c0379
2 changed files with 53 additions and 0 deletions

View file

@ -246,6 +246,46 @@ GET /health</code></pre>
<p>Walk-through: <a href="../extensions/publish/">theseus.x/extensions/publish</a>.</p>
</section>
<section id="claude">
<h2>Connect <span class="g">Claude</span> to Theseus</h2>
<p>The built-in <b>Claude connector</b> is a local MCP server: Claude Code or Claude Desktop on the
same computer can open and read your tabs, click, type into rich editors, paste formatted text and
upload files, in the profile where you are already signed in. It is off until you turn it on, and
it reaches nothing beyond this computer.</p>
<h3>Set it up</h3>
<ol>
<li>Turn it on in <b>Settings › Extensions › Claude connector</b>. Its panel (the connector icon in
the toolbar) shows the address, the token, the sites you have approved, the upload folders and a
live log.</li>
<li>Copy the command from the panel and run it once. <code>--scope user</code> makes it available in
every project:</li>
</ol>
<pre><code>claude mcp add --scope user --transport http theseus http://127.0.0.1:47800/mcp --header <span class="s">"Authorization: Bearer &lt;token from the panel&gt;"</span></code></pre>
<p><code>claude mcp list</code> should then show <code>theseus</code> as connected. For <b>Claude Desktop</b>,
the panel's <i>Claude Desktop</i> tab has a ready <code>claude_desktop_config.json</code> entry. It runs
a small stdio relay through the Theseus executable itself, so there is nothing else to install.</p>
<h3>What Claude can do</h3>
<p><code>list_tabs</code>, <code>open_tab</code>, <code>navigate</code>, <code>activate_tab</code>,
<code>close_tab</code>, <code>screenshot</code>, <code>read_page_text</code>, <code>snapshot</code>
(the accessibility tree, with a ref per element), <code>click</code>, <code>type</code>,
<code>press_key</code>, <code>paste_html</code>, <code>paste_text</code>, <code>upload_file</code>,
<code>wait_for</code>, and <code>evaluate</code> while you allow it. Typing is real key input and
pastes go through the system clipboard and the browser's own paste, so editors such as Medium's
accept them; your clipboard is put back afterwards.</p>
<div class="note"><b>What keeps you in charge.</b> The connector listens on 127.0.0.1 only, behind a
random token; requests from web pages are refused. There is no browser-wide debugging port: each
tab is driven on its own. Theseus asks the first time Claude acts on a site. Password and one-time-code
fields are always refused, files can be uploaded only from folders you add, and running page scripts
(<code>evaluate</code>) is a separate switch, off by default. Every action is logged with its time.
The toolbar chip's ✕ stops the connector at once; <i>Revoke token</i> cuts off every client you set
up.</div>
<p>The connector ships with the next Theseus release after 0.3.106. Design notes:
<a href="https://code.silentmode.st/silentmode/theseus/src/branch/master/DESIGN-claude-connector.md">DESIGN-claude-connector.md ↗</a>.</p>
</section>
<section id="plug-ins">
<h2>Plug-ins <span class="g">(first-party)</span></h2>
<p>Plug-ins are the few add-ons Silent Mode builds, signs with the operator key, and ships as

View file

@ -272,6 +272,19 @@
</div>
</div>
<div class="ext" id="claude-connector">
<h3><span class="icon" aria-hidden="true"><svg width="20" height="20" viewBox="0 0 64 64" xmlns="http://www.w3.org/2000/svg" style="vertical-align:middle"><rect x="4" y="4" width="56" height="56" rx="14" fill="#d97757"/><path d="M32 13v38M13 32h38M18.6 18.6l26.8 26.8M45.4 18.6 18.6 45.4" stroke="#fff4ee" stroke-width="6" stroke-linecap="round"/></svg></span> Claude connector <span class="cur" style="margin-left:auto">bundled 0.1.0</span></h3>
<div class="desc">Lets Claude Code or Claude Desktop on your computer work in your signed-in tabs through a
local MCP connection: read pages, click, type into rich editors, paste formatted text, upload files.
Off until you turn it on. Theseus asks before Claude touches each new site, never lets it type into
a password field, uploads only from folders you choose, and logs every action. A <i>Claude</i> chip
in the toolbar shows while a client is connected; its ✕ stops everything.</div>
<div class="meta">Settings › Extensions · off by default · ships with the next Theseus release (after 0.3.106)</div>
<div class="act">
<span class="hint" style="margin-left:0"><b>Ships with Theseus</b> — nothing to install. Setup: <a href="../dev/#claude">theseus.x/dev/#claude</a>.</span>
</div>
</div>
<div class="nomatch note" id="nomatchBundled">No bundled extension matches that search.</div>
</section>