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:
parent
c7ceaa6c18
commit
70a71c0379
2 changed files with 53 additions and 0 deletions
|
|
@ -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 <token from the panel>"</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
|
||||
|
|
|
|||
|
|
@ -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>
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue