PandaNpc MCP -palvelimen määrittäminen Claude Codea ja Codexia varten

Päivitetty

PandaNpc MCP -palvelin yhdistää MCP-yhteensopivan koodausagentin PandaNote-tietokantaasi, työlokeihisi, ajastettuihin tehtäviin, mallikonfiguraatioon ja Agent Service Centeriin. Se on hyödyllinen, kun agentti tarvitsee pysyvää projektikontekstia sen sijaan, että se aloittaisi joka kerta tyhjästä keskustelusta.

Palvelin toimii paikallisesti MCP:n vakio syöttö/tulostus -siirrolla. MCP-asiakasohjelmasi käynnistää pandanpc-mcp-prosessin, kun istunto avautuu; sinun ei tarvitse avata porttia tai käynnistää erillistä verkkopalvelinta.

Ennen asennusta

Tarvitset:

  • Node.js ja npm samassa ympäristössä, jossa MCP-asiakasohjelma toimii.
  • PandaNpc-tilin, jolla on pääsy vahvistuksessa käytettävään sähköpostiosoitteeseen.
  • Claude Code, OpenAI Codex, Cursor tai muu asiakasohjelma, joka tukee paikallisia stdio MCP -palvelimia.

Jos haluat, että agentti ajastaa töitä jollakin omista tietokoneistasi, asenna ja yhdistä PandaPaw ensin. Muistiinpano- ja työtilaustyökalut eivät vaadi online-PandaPaw-laitetta.

MCP-palvelimen asentaminen tai päivittäminen

Asenna paketti globaalisti macOS:ssä, Linuxissa tai Windowsissa:

bash
npm install -g @pandanpc/mcp-server

Varmista, että suoritettava tiedosto on shellisi näkyvissä:

bash
pandanpc-mcp --help

Aja sama npm-komento aina kun haluat päivittää. Käynnistä MCP-asiakasohjelma uudelleen päivityksen jälkeen, koska jo käynnissä oleva asiakasohjelma pitää sen prosessiversion, jonka se alun perin käynnisti.

Tarkista MCP-palvelimen versiohistoria, kun työkalu tai sen toiminta eroaa vanhemmasta kuvakaappauksesta tai opetusohjelmasta.

PandaNpc:n lisääminen Claude Codeen

Luotettavin tapa on Claude Coden oma määrityskomento. Käytä user-aluetta, jos haluat PandaNpc:n olevan käytettävissä jokaisessa projektissa:

bash
claude mcp add --scope user pandanpc -- pandanpc-mcp

Käytä sen sijaan --scope project, kun määritys pitäisi jakaa nykyisen repositorion kautta, tai --scope local, kun sen pitäisi koskea vain sinua nykyisessä projektissa.

Tarkista rekisteröity palvelin:

bash
claude mcp get pandanpc
claude mcp list

Voit myös määrittää stdio-palvelimen manuaalisesti MCP-määritykseen, jota Claude Code -asennuksesi käyttää:

json
{
  "mcpServers": {
    "pandanpc": {
      "command": "pandanpc-mcp"
    }
  }
}

PandaNpc:n lisääminen OpenAI Codexiin

Codex voi rekisteröidä saman paikallisen prosessin komentoriviltä:

bash
codex mcp add pandanpc -- pandanpc-mcp

Varmista tallennettu määritys:

bash
codex mcp get pandanpc
codex mcp list

Vastaava merkintä ~/.codex/config.toml-tiedostossa on:

toml
[mcp_servers.pandanpc]
command = "pandanpc-mcp"

Käynnistä Codex uudelleen tai avaa uusi istunto palvelimen lisäämisen jälkeen. Jos ylläpidät mukautettua Codex-määritystiedostoa, laita MCP-taulukko siihen tiedostoon sen sijaan, että kopioisit sen useisiin tiedostoihin.

Cursorin ja muiden MCP-asiakasohjelmien määrittäminen

Lisää Cursorille paikallinen palvelin ~/.cursor/mcp.json-tiedostoon käyttäen samaa JSON-muotoa kuin Claude Code -esimerkissä. Windsurfille ja muille asiakasohjelmille luo stdio MCP -palvelin, jonka komento on pandanpc-mcp ja jonka argumenttilista on tyhjä.

Suoritettavan tiedoston on oltava graafisen sovelluksen perimällä PATH-polulla. Jos se toimii terminaalissa, mutta työpöytäasiakasohjelma ilmoittaa "komentoa ei löytynyt", käytä absoluuttista suoritettavan tiedoston polkua, jonka seuraava komento palauttaa:

bash
command -v pandanpc-mcp

Windows PowerShellissä käytä:

powershell
Get-Command pandanpc-mcp

Kirjautuminen agentin kautta

PandaNpc käyttää kaksivaiheista sähköpostivahvistusmenettelyä. Pyydä agenttia suorittamaan nämä toimet järjestyksessä:

  1. Kutsu note_login-toimintoa sähköpostiosoitteellasi. PandaNpc lähettää vahvistuskoodin.
  2. Kutsu note_login-toimintoa uudelleen samalla sähköpostiosoitteella ja koodilla.

Paikallinen tunnistetieto tallennetaan välimuistiin, joten sinun ei pitäisi joutua kirjautumaan joka istunnossa. Älä koskaan liitä vahvistuskoodia julkiseen keskustelutallenteeseen tai jaettuun kehotteeseen.

MCP-yhteyden vahvistaminen

Suorita pieni vain luku -testi ennen kuin annat agentin luoda tai muokata tietoja:

  1. Pyydä sitä kutsumaan list_workspaces-toimintoa.
  2. Pyydä sitä kutsumaan list_notes-toimintoa yhdelle työtilalle.
  3. Pyydä sitä etsimään harmiton avainsana search_notes-toiminnolla.

Onnistunut vastaus osoittaa, että MCP-asiakasohjelma käynnisti prosessin, todennus onnistui ja tilin API on tavoitettavissa. Kirjoitustestiä varten luo kertakäyttöinen muistiinpano ja poista se sitten pehmeästi.

Tarkka työkaluluettelo, jonka MCP-asiakasohjelmasi näyttää, on asennetun version totuudenlähde. Työkalut on ryhmitelty näiden työnkulkujen ympärille:

Työnkulku Tyypilliset työkalut Tärkeä käyttäytyminen
Muistiinpanot list_notes, create_note, read_note, update_note, search_notes update_note korvaa koko sisällön; lue ennen muokkaamista
Työlokit save_done Tallentaa valmistuneen työn automaattisesti päivän projektikansioon
Työtilat list_workspaces, create_workspace, update_workspace Sidottu projektipolku auttaa palvelinta löytämään oikean työtilan
Ajastetut työt list_scheduled_bridges, create_scheduled_task, list_scheduled_task_runs PandaPaw-laitteen on oltava verkossa; cron-lausekkeet käyttävät kuutta kenttää
Palveluntarjoajat ja mallit list_providers, list_models, luonti/päivitys/poisto-työkalut Listaa ensin, jotta käytät nykyisiä tunnuksia ja kelvollisia mallityyppejä
Säännöt ja taidot sync_rules Synkronoi tuetut projektiohjeet ohittaen muuttumattomat tiedostot

Palveluntarjoajien ja mallien kenttämääritykset löytyvät kohdasta Custom AI providers and API keys. Tili- ja laskutusrajoista katso PandaNpc accounts, plans, and API costs.

Turvalliset toimintatavat

  • Aloita lista-, luku- tai hakutyökaluilla ennen luonti-, päivitys-, poisto- tai ajastustoimia.
  • Lue muistiinpano ennen sen päivittämistä, koska muistiinpanopäivitykset korvaavat koko Markdown-dokumentin eivätkä sovella korjausta.
  • Käsittele ajastettuja kehotteita koodin suorituspyyntöinä: varmista kohdekone, työhakemisto, aikavyöhyke ja kuusikenttäinen cron-lauseke.
  • Pidä palveluntarjoajien API-avaimet poissa kehotteista ja muistiinpanoista. Syötä salaisuudet vain palveluntarjoajan tarkoitetun määritysprosessin kautta.
  • Tarkista MCP-työkalun hyväksyntäkortti ennen tuhoavien tai ulkoisten toimien sallimista.
  • Käytä save_done-toimintoa työlokeihin sen sijaan, että arvaisit oikean työtilan ja päivämääräkansion.

Vianmääritys

Asiakasohjelma ilmoittaa, ettei `pandanpc-mcp` löytynyt

Avaa uusi terminaali asennuksen jälkeen ja tarkista suoritettavan tiedoston polku. Työpöytäsovellukset perivät joskus vanhemman PATH-muuttujan; määritä absoluuttinen polku tai käynnistä sovellus uudelleen. Jos npm on asennettu versiohallinnan kautta, varmista, että MCP-asiakasohjelma käynnistyy saman käyttäjän ja ympäristön alaisuudessa.

Palvelin on rekisteröity, mutta työkaluja ei näy

Käynnistä asiakasohjelma uudelleen ja tarkista sitten claude mcp get pandanpc tai codex mcp get pandanpc. Poista ja lisää merkintä uudelleen, jos komento on väärä. Tarkista myös, ettet määrittänyt paikallista stdio-prosessia HTTP-URL-osoitteeksi.

Työkalut ilmoittavat, että et ole todennettu

Toista kaksi note_login-kutsua. Käytä uusinta vahvistuskoodia, tarkista roskapostikansio ja varmista, että molemmat kutsut käyttävät samaa sähköpostiosoitetta.

Ajastetut tehtävät eivät löydä konetta

Kutsu ensin list_scheduled_bridges-toimintoa. Jos se ei palauta käytettävissä olevaa laitetta, tarkista PandaPaw-tila ja laitteen liitettävyys kohdekoneella. Kone, joka on sammutettu, lepotilassa, uloskirjautunut tai yhteydetön, ei voi käynnistää ajastettua suoritusta.

Muistiinpanopäivitys poisti olemassa olevaa tekstiä

update_note hyväksyy koko korvaavan sisällön. Palauta muistiinpano historiasta tai roskakorista, jos saatavilla, lue sitten nykyinen sisältö ja lähetä yhdistetty asiakirja.

Tarvitsetko tiliin liittyvää apua? Ota yhteyttä support@pandanpc.com ja liitä mukaan MCP-asiakasohjelman nimi, käyttöjärjestelmä, pakettiversio ja tarkka virheilmoitus ilman salaisuuksia.