Skip to main content
AgencyHandyn MCP-yhteys antaa puhua Claudelle tai Cursorille arkikielellä ja suorittaa päivittäistä työtä AgencyHandy-työtilassa — avaamatta jokaista näyttöä itse. Sinä säilytät hallinnan. Claude ja Cursor toimivat vain generoimallasi työtilan API-avaimella ja pyytävät vahvistusta, kun nimi vastaa useampaa henkilöä.
Tarvitset roolin, joka voi avata Workspace Configin ja hallita API keys (yleensä SuperAdmin tai Admin). Tarvitset myös Node.js 20+ tietokoneella, jossa Claude Desktop tai Cursor toimii.

​
Vaatimukset

npm:n MCP-paketti on agencyhandy-mcp. Claude ja Cursor suorittavat sen komennolla npx -y agencyhandy-mcp@1.

​
Claude- tai Cursor-MCP:n määritys

1

Avaa Workspace Config

Avaa AgencyHandyssa Workspace Config (yritysasetukset) ja siirry API Key -välilehdelle.
2

Luo työtilan API-avain

Luo uusi työtilan API-avain (tai käytä tallennettua). Kopioi avain, kun se näkyy — AgencyHandy ei voi näyttää täyttä avainta myöhemmin uudelleen.
3

Kopioi MCP-määritys

Samalla API Key -välilehdellä käytä Claude / Cursor MCP -paneelia. Napsauta Copy MCP config, jotta JSON sisältää avaimesi ja backend-URL:n.
4

Liitä Cursoriin tai Claude Desktopiin

Liitä määritys:
  • Cursor: projektin tai käyttäjän .mcp.json
  • Claude Desktop: claude_desktop_config.json
Pidä komento npx -y agencyhandy-mcp@1 ja API-avain sellaisina kuin ne generoitiin.
5

Käynnistä uudelleen ja kokeile kehotetta

Sulje Cursor tai Claude Desktop kokonaan ja avaa uudelleen. Pyydä sitten jotain yksinkertaista, esimerkiksi työtilan aamubriffiä.
Jos Claude tai Cursor ei löydä MCP-palvelinta, varmista Node.js 20+ ja käynnistä sovellus uudelleen määrityksen tallennuksen jälkeen.

​
Esimerkkikehotteet

Käytä luonnollista kieltä. Suosi täyttä nimeä tai sähköpostia työtä määrätessäsi, jotta oikea henkilö valitaan.

​
Kun kahdella henkilöllä on sama nimi

Jos tiimissä on kaksi Saraa, Claude kysyy kumpaa tarkoitat. Se ei keksi ID:itä eikä arvaa hiljaa. Sisällytä kehotteeseen aina koko nimi tai sähköposti, kun nimet voivat törmätä.

​
Mikä toimii nyt vs ei vielä

MCP tukee työtilan lukemista ja toimintoja (luo, määrää, lähetä, päivitä) API-avaimellasi. Asiakaschat-vastaukset eivät ole vielä MCP:n kautta — käytä AgencyHandya näihin keskusteluihin.

​
Aiheeseen liittyvää

  • Luo avaimia ja kopioi määritys sovelluksessa: Workspace Config → API Key
  • Paketti: agencyhandy-mcp npm:ssä (npx -y agencyhandy-mcp@1)
Latest package on the 1 tag is 1.7.2+. Claude can read ah://api-context (also inside ah://full-context) for API path gotchas: leads, projects/orders, tasks, comments, labels, clients, invoices, vouchers, and forms.