Hayaan ang iyong coding agent na gumamit ng browser na naka-sign in ka na.

Ano ang nagsisimula saan

Isinisimula ng iyong MCP client ang npm package bilang lokal na child process sa pamamagitan ng stdio. Ang process na ito ay nakikinig lamang sa 127.0.0.1:17374. Tinatawagan ito ng extension, pagkatapos isinasagawa ang bawat task sa pamamagitan ng agent loop ng WebBrain sa napiling tab ng browser.

Hindi ang server ay ikalawang browser at hindi kinokopya ang mga cookie. Ito ay lokal na handoff point sa pagitan ng MCP client at ng extension. Hindi gumagalaw ang browser profile — kaya't ang naka-authenticate na session.

Bago magkonekta

Irehistro ang server sa iyong MCP client

Gamitin ang isa sa mga sumusunad na client-specific na configuration, isang beses lang. Mga ito ay command ng pag-install, hindi ang paraan ng paghiling ng browser task. Pagkatapos ng pagrehistro, sisimulan ng client ang server para sa iyo at patuloy kang magchachat; huwag patakbuhin nang sabay ang manual na kopya sa parehong port.

Codex app, CLI, o IDE extension

codex mcp add webbrain -- npx -y @webbrain/mcp-server

Iniimbak ng Codex ang mga MCP server sa ~/.codex/config.toml; ibinahagi ng app, CLI, at IDE extension sa parehong Codex host ang configuration na iyon. Para sa matitagal na browser task, buksan ang file at bigyan ang tool ng mas maraming oras kaysa sa default na budget ng Codex kada tawag:

[mcp_servers.webbrain]
command = "npx"
args = ["-y", "@webbrain/mcp-server"]
tool_timeout_sec = 360

I-restart ang app o IDE extension pagkatapos baguhin ang file. Sa CLI, patakbuhin ang codex mcp list upang kumpirmahin ang entry at gamitin ang /mcp sa isang Codex session upang suriin ang nakakonektang server. Tingnan ang opisyal na Codex MCP guide para sa shared host configuration at lahat ng sinusuportahang opsyon.

Claude Code

claude mcp add --transport stdio webbrain -- npx -y @webbrain/mcp-server

Tutugma ang malinaw na transport sa kasalukuyang Claude Code MCP configuration. Pagkatapos idagdag, patakbuhin ang claude mcp list upang suriin ang kalusugan ng server.

Cursor

Magdagdag ng lokal na stdio server sa mga setting ng MCP ng Cursor, o ilagay ang nilalamang ito sa MCP JSON file na ginagamit ng Cursor. Sinusundan ng format ang Cursor local MCP server format:

{
  "mcpServers": {
    "webbrain": {
      "command": "npx",
      "args": ["-y", "@webbrain/mcp-server"]
    }
  }
}

OpenCode

Idagdag ang entry na ito sa ~/.config/opencode/opencode.json, gamitin ang local MCP server format ng OpenCode:

{
  "mcp": {
    "webbrain": {
      "type": "local",
      "command": ["npx", "-y", "@webbrain/mcp-server"]
    }
  }
}

OpenClaw

Irehistro ang WebBrain sa OpenClaw bilang outbound na MCP server. Huwag gamitin ang openclaw mcp serve para sa integrasyong ito: ginagawa ng utos na iyon ang OpenClaw mismo na server, kabaligtaran ng direksyon.

openclaw mcp add webbrain \
  --command npx \
  --arg -y \
  --arg @webbrain/mcp-server \
  --timeout 360

Susuriin ng mcp add ang stdio server bago ito i-save. Patakbuhin ang openclaw mcp status --verbose upang suriin ang naka-save na depinisyon. Kasama ng mga karaniwang coding at messaging tool profile ang mga naka-configure na MCP server; maaaring itago ang mga ito ng minimal profile, malinaw na pagtanggi ng bundle-mcp, o sandbox tool policy. Tingnan ang OpenClaw MCP guide para sa kasalukuyang registry at detalye ng policy.

Patakbuhin nang manual

Kapaki-pakinabang ang manual na paglunsad para i-diagnose ang listener, ngunit hindi kinakailangan sa normal na paggamit ng MCP:

npx -y @webbrain/mcp-server

Panatilihing bukas ang terminal na iyon. Kung isasara ito, isasara rin ang bridge listener. Mula sa source checkout, patakbuhin ang npm install, npm run build, at pagkatapos ang npm start sa loob ng mcp-server/.

Ituwid ang WebBrain sa lokal na listener

1. Isimulan o i-restart ang iyong MCP client. Dapat na gumagana ang server ng WebBrain bago makapagkonekta ang extension.
2. Buksan ang mga Setting ng WebBrain. Pumunta sa Mga Setting → Bridge.
3. Itakda ang eksaktong URL. I-type ang ws://127.0.0.1:17374/extension.
4. I-paste ang pairing key. Patakbuhin sa terminal ang npx -y @webbrain/mcp-server pairing-key (o buksan ang ~/.webbrain/bridge-key) at i-paste ang key sa field ng Pairing key. Pinagkakatiwalaan lang ng server ang browser na mapatutunayang hawak nito ang key na iyon. Kung wala ang field, i-update muna ang WebBrain.
5. Paganahin ang cloud bridge. Dapat magbago ang status mula "Kumokonekta" tungo sa "Nakakonekta". Dahil sa kasaysayan ang pangalan: lokal ang target na ito.
6. I-verify ang end-to-end na koneksyon. Hilingin ang MCP client na tumawag ng webbrain_connection. Pinatutunayan ng "Connected" na handa na ang client, lokal na server, WebSocket listener, at handshake ng extension.

Ilarawan ang browser task sa natural na wika

Sa Codex, Claude Code, Cursor, OpenClaw, o OpenCode, isulat ang hiling na parang ito ay ibibigay mo sa katrabaho. Ginagawang walang kalituhan ng pagbanggit sa WebBrain ang intensyon mo; isama ang page, inaasahang resulta, saklaw, at kung pinapayagan ang mga pagbabago.

Pagbabasa nang hindi binabago ang page

Gamitin ang WebBrain para basahin ang Stripe dashboard na bukas na sa aking browser. Ilista ang mga nabigong pagbabayad sa nakalipas na pitong araw kasama ang customer, halaga, currency, petsa, at dahilan ng kabiguan. Huwag baguhin ang kahit ano.

Pagbabalik ng predictable na JSON

Kunin ng WebBrain ang lahat ng overdue na invoice mula sa dashboard na bukas na sa aking browser. Magbalik ng JSON na may customer, halaga, currency, due date, at invoice URL. Huwag baguhin ang kahit ano.

Pakikipag-ugnayan sa page

Gamitin ang Act mode ng WebBrain para buksan ang record ng customer na nakikita na sa aking browser at i-update ang pangalan ng kompanya sa Acme Europe. Huminto bago ang kahit anong final na pagsusumite o pagkumpirma.

Pipiliin ng coding agent ang webbrain_run para sa pangkalahatang pagbabasa o pakikipag-ugnayan, at ang webbrain_extract kapag humiling ng structured na data. Ibinibigay nito ang mga argumento, binabantayan ang run, at inilalapat ang resulta ng WebBrain pabalik sa usapan. Maaaring magbasa at mag-extract ang Ask mode; hindi maaaring mag-click, mag-type, mag-navigate, o magsumite. Maaaring makipag-ugnayan ang Act mode, sa ilalim ng normal na permiso sa browser ng WebBrain.

webbrain_run(
  task: "read the open Stripe dashboard and list failed payments from the last 7 days with customer, amount, currency, date, and failure reason",
  mode: "ask"
)

Para sa mga task na nangangailangan ng pakikipag-ugnayan, sabihin nang malinaw na "gamitin ang Act mode ng WebBrain" at panatilihing nakikita ang browser. Ilalapat ng WebBrain ang normal nitong mga prompt ng aprubal ng kakayahan kada pinagmulan.

Mga tool na ginagamit ng iyong MCP client para sa iyo

Kadalasan, pinipili mo ang resulta, hindi ang tool. Binabasa ng iyong MCP client ang mga paglalarawang ito, pinipili ang naaangkop na tool, pinupuno ang mga input nito ayon sa hiling mo, at hinahawakan ang mga susunod na tawag. Nandito ang reference na ito para maunawaan o i-debug mo ang gawing iyon.

Humiling ng structured na JSON

Sa normal na paggamit, sabihin kung ano ang kukunin at pangalanan ang mga gustong field: "gamitin ang WebBrain para kunin ang lahat ng overdue na invoice mula sa bukas na dashboard at magbalik ng JSON na may customer, halaga, currency, due date, at invoice URL." Maaaring isalin ng mahusay na MCP client ang mga field na iyon sa kinakailangang schema at tatawagin ang webbrain_extract para sa iyo.

Ipinapakita ng halimbawang anyo-function sa ibaba ang katumbas na tool call para sa mga developer ng client at debugging. Ilarawan ang lohika ng pagpili sa task; ilarawan lamang ang hugis ng output sa output_schema.

webbrain_extract(
  task: "extract every overdue invoice visible in this account; preserve the displayed currency and use ISO dates where the page provides a full date",
  output_schema: {
    type: "object",
    properties: {
      invoices: {
        type: "array",
        items: {
          type: "object",
          properties: {
            customer: { type: "string" },
            amount: { type: "number" },
            currency: { type: "string" },
            due_date: { type: "string" },
            invoice_url: { type: "string" }
          },
          required: ["customer", "amount", "currency", "due_date"]
        }
      }
    },
    required: ["invoices"]
  }
)

• Gumamit ng object root na may malinaw na mga field na properties at required.
• Humiling ng pinakamakitid na data na kailangan mo. Hindi nagbibigay ang schema ng access sa data na hindi nakikita ng browser session.
• Read-only ang tool, ngunit ipinapadala pa rin ang text ng page at resulta sa LLM provider na naka-configure sa WebBrain.
• Kung masyadong malaki ang resulta para sa persistent snapshot ng run, maaaring iulat ng status na na-truncate ang naka-imbak na resulta. Litiin ang hiling at ulitin.

Unawain ang lifecycle ng run

Hinahawakan ng karamihan sa mga MCP client ang lifecycle na ito para sa iyo: hinihintay nila ang resulta, ipinapakita ang tanong ng WebBrain para sa paglilinaw kapag kailangan ng input ng tao, at nagpapatuloy sa sagot mo. Kapaki-pakinabang ang mga malinaw na tawag sa ibaba para sa mga developer ng client, pag-troubleshoot, o sinasadyang pagsisimula ng mahabang task sa background ng client.

Default na naghihintay ang mga foreground call. Para sa matitagal na trabaho, maaaring itakda ng client ang wait: false at mag-poll gamit ang webbrain_status.

# Reference sa antas ng tool
# Simulan nang hindi naghihintay
webbrain_run(task: "compare the invoices across all visible pages", mode: "ask", wait: false)

# I-poll ang naibalik na ID
webbrain_status(run_id: "mcp_…")

Ibinabalik ng timeout ng run ng WebBrain ang kontrol sa MCP client ngunit sinasadyang hindi inihihinto ang browser task. I-poll ang naibalik na run_id. Pinipigilan nito na pumatay nang tahimik ng timeout ang task matapos itong maaaring gumawa na ng mga makabuluhang aksyon.

Kapag nagtanong ang WebBrain

Nilalaman ng naka-pause na snapshot ng isang tanong na nababasa ng tao at ng clarify_id. Ipakita ang tanong sa user. Ipadala ang sagot nila nang salita-sa-salita; huwag maghaka.

webbrain_respond(
  run_id: "mcp_…",
  clarify_id: "clarify_…",
  answer: "Use the Acme EU account."
)

Pumili ng pinakamaliit na awtoridad

Magkakahiwalay na layer ang aprubal ng MCP client at ng WebBrain. Maaaring magtanong ang client mo bago tumawag ng webbrain_run; maaaring magtanong ang WebBrain bago ang makabuluhang aksyon sa isang pinagmulan. Hindi pumapalit ang isa sa kabilang aprubal.

Mga hangganan ng seguridad na dapat mong panatilihin

• Panatilihing lokal ang listener. Nakatali ito sa 127.0.0.1. Huwag i-forward ang port 17374, i-publish sa container bridge, o i-proxy sa network.
• Itago nang maayos ang pairing key. Hindi sapat ang loopback bilang authentication, kaya pinagkakatiwalaan ng server ang socket lamang kapag sinagot nito ang isang bagong challenge gamit ang HMAC na naka-key sa pairing key; hindi kailanang ipinapadala ang mismong key sa socket. Sinumang makakabasa ng ~/.webbrain/bridge-key ay makapag-pair, kaya huwag i-paste ang key sa chat. Hindi beripika ng extension ang pagkakakilanlan ng server, kaya pa rin ituring ang lokal na code at MCP package na mapagkakatiwalaang software.
• Gamitin muna ang Ask. Mas madaling beripika ang read-only na trabaho at mas maliit ang blast radius nito.
• Panatilihing nakikita ang browser para sa Act. Maaari mong ihinto ang run sa side panel; ang hindi inaasahang navigation o pag-type ay dapat ituring na dahilan ng paghinto.
• Tandaan ang hangganan ng provider. Nanatiling lokal ang MCP bridge, ngunit ipinapadala ang nilalaman ng page sa model provider na naka-configure sa WebBrain. Gumamit ng lokal na model kapag dapat na manatili sa device ang nilalaman.
• Huwag ituring ang timeout bilang rollback. Inihinto ng pag-abort ang mga susunod na hakbang; hindi nito mababalik ang naipadalang email, naisumiteang form, pagbili, o ibang nakumpletong aksyon.

Para sa buong disenyo, tingnan ang security model, privacy at daloy ng data, at ang gabay sa mga mode, kaligtasan, at privacy.

Pag-troubleshoot ayon sa sintomas

Configuration ng environment

Para sa mga stdio client, itakda ang mga environment variable sa MCP configuration ng client na iyon. Kung magbabago ka ng port o path, eksaktong i-update ang cloud bridge URL sa mga Setting ng WebBrain upang tumugma.

Gumamit ng LM Studio?

Ginagamit ng LM Studio ang hiwalay na WebBrain Web Tools plugin, hindi ang MCP package na ito. Maaaring basahin ng mga tool nitong fetch_url at research_url ang mga pampublikong page nang hindi nangangailangan ng browser extension; maaaring ipagkatiwala ng mga browser tool nitong ang target sa iyong naka-sign in na Chromium session sa pamamagitan ng port 17375.