Para sa mga user ng Claude Desktop

Hindi nakikita ng Claude Desktop ang repo mo. Bigyan mo ito ng isa.

Sa Claude Desktop nagtatanong ang maraming tao tungkol sa code na hindi nila ine-edit ngayon: mga review, onboarding, incident call. Ini-index ng Maguyva ang repo at sine-serve ito sa pamamagitan ng MCP, kaya file at line ang binabanggit ng mga sagot, hindi alaala.

Magsimula nang libre Basahin ang setup sa Claude Desktop

May Free tier: 3 repository, Hanggang 50K na naka-index na linya ng repo, walang card.

Hindi kailangan ng checkout. Tanungin ang index.

Ang kailangang malaman tungkol sa Claude Desktop

Apat na fact na partikular sa Claude Desktop.

// config file nito

claude_desktop_config.json

Binubuksan ito ng Settings → Developer → Edit Config. Sa macOS, nasa ~/Library/Application Support/Claude/ ito; sa Windows, nasa %APPDATA%\Claude\.

// paraan ng koneksyon

Ang local bridge

Nagsisimula ang file na ito ng mga local na proseso, kaya pinapatakbo ng guide na ito ang @maguyva/mcp sa pamamagitan ng npx. Kailangang naka-install ang Node.js.

// ang key

Isang env entry

Binabasa ng bridge ang MAGUYVA_API_KEY mula sa env block ng server sa parehong file.

// pag-restart

Mag-quit, saka buksan ulit

Binabasa ng Claude Desktop ang file sa pag-launch. I-quit nang buo ang app pagkatapos itong i-edit; magsisimula ang server sa susunod na launch.

Ang project instructions ang nagtatakda ng brief. Gamitin ang mga ito.

Hawak ng Claude Projects ang mga instruction at file na pinagsisimulan ng bawat chat sa project. Ang mga ito ang tamang lugar para sa:

Para kanino ang mga sagot: isang reviewer, isang bagong hire, isang on-call engineer.
House style para sa mga paliwanag at summary.
Ilang dokumentong gusto mong ma-quote, gaya ng architecture overview.

Snapshot ang mga in-upload na file. Isang araw pagkatapos mo itong i-upload, gumalaw na ang repo.

Kapag kulang na ang na-paste na code

Tatlong paraan na nagkakamali ang usapan tungkol sa code kapag wala ang code.

// lumuluma ang mga na-paste na snippet

Ang file na na-paste sa chat noong nakaraang linggo ay naglalarawan ng code noong nakaraang linggo. Kumpiyansang sumasagot si Claude mula sa bersyong ibinigay sa kanya.

// hindi ang buong system ang snippet

Bihirang masagot ng isang file ang “ano ang mangyayari kapag pumalya ito?” Kadalasan nasa tatlong magkakaibang package ang handler, ang retry, at ang alert.

// walang checkout, walang grep

Walang working copy ng repo mo ang Claude Desktop. Kung walang tool, bawat sagot tungkol sa structure ay nakadepende sa naalala mong i-paste.

Maguyva bilang MCP server sa Claude Desktop

Ang isang mcpServers entry ay nagbibigay kay Claude ng:

11 na tool sa naka-index mong repo semantic, structural (AST), graph, at text search, kasama ang symbol lookup, mga dependent, at pagkuha ng file.
Mga sagot na may file path at line number sa 285+ na wika, kaya masusuri mo ang bawat claim.
Branch-aware na mga resulta kaya sumasagot si Claude tungkol sa branch na pinangalanan mo, hindi sa file na in-upload ng kung sino noong nakaraang buwan.

Sinasabi ng project instructions kay Claude kung paano sumagot.
Binibigyan ng Maguyva si Claude ng code na pagbabatayan ng sagot.

Dalawang workflow

Mga tanong na karaniwang sinasagot mo sa pagbubukas ng IDE.

// workflow 01

Ipaliwanag ang isang code path habang nagre-review

claude> ano ang nangyayari kapag pumalya sa signature check ang isang payment webhook?

semantic_search("webhook signature verification failure")
  src/payments/webhooks.ts:64   verifySignature()
  src/payments/webhooks.ts:91   rejectAndAlert()

→ Sumasagot si Claude nang binabanggit ang dalawang line.
[exit 0]

Bawat hakbang ng sagot ay tumuturo sa isang file at line na mabubuksan mo.

// workflow 02

Sukatin ang laki ng pagbabago bago ito planuhin

claude> ilang lugar ang nagbabasa ng legacy na plan_code field?

text_pattern_search("plan_code")
  14 na tugma sa 9 na file
dependency_search("getPlanCode", dependents)
  6 na caller

→ Nagsisimula ang estimate sa bilang, hindi sa hula.
[exit 0]

Kapaki-pakinabang sa planning meeting, kapag walang nakabukas na repo.

Setup sa Claude Desktop

Tatlong hakbang. Free tier: 3 repository, Hanggang 50K na naka-index na linya ng repo, walang card.

// step 01

I-index ang isang repo sa maguyva.ai

Pumili ng isang alam mo na, para masuri mo ang mga sagot.

// step 02

Idagdag ang Maguyva sa claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

// step 03

Palitan ang placeholder, i-restart, at magtanong ng isa

Palitan ang mgv_xxxx ng API key mo, i-quit nang buo ang Claude Desktop, at buksan ulit. Kung hindi lumabas ang server, basahin ang mcp-server-maguyva.log sa logs folder ni Claude (~/Library/Logs/Claude sa macOS).