Liidestused
Numera MCP server
Ühenda AI-agent (Claude Code, Codex, Cursor jt) Numera projektide ja pakkumistega: agent näeb ülesandeid, epicuid, sprinte ja dokumente ning koostab projektipakkumisi.
Uuendatud
Numera MCP server võimaldab ühendada AI-agendi (näiteks Claude Code, Codex või Cursor) oma ettevõtte projektihaldusega. Kui ühendus on loodud, saab agent ise vaadata sinu projektide ülesandeid, epicuid, faase, sprinte, projekti dokumente (lepingud, pakkumised, koosolekumärkmed) ja projekti seina postitusi — ilma et peaksid infot käsitsi kopeerima. Kirjutusõigusega võtmega saab agent ka ise ülesandeid, epicuid, faase ja sprinte luua ja muuta, kommentaare postitada ning ülesannetele tööaega logida. Pakkumiste mooduliga koostab agent terve projektipakkumise — faasid, tööpaketid, hinnangud, sektsioonid, küsimused — mustandina, mille sina üle vaatad ja Numerast saadad.
See on eriti kasulik arendustöös: kui projekti haldad Numeras ja koodi kirjutab AI-agent, saab agent enne otsuste tegemist ise üle vaadata, mis on kokku lepitud lepingus, millised ülesanded on sprindis ja mida on projekti seinal arutatud.
Mis on MCP?
MCP ehk Model Context Protocol on avatud standard, mille kaudu AI-agendid saavad turvaliselt suhelda välisrakendustega. Numera MCP server on "tõlk" sinu AI-agendi ja Numera vahel: agent küsib (näiteks "millised ülesanded on juuli sprindis?"), server kontrollib sinu õigusi ja tagastab andmed otse Numerast.
Kuna MCP on avatud standard, töötab Numera MCP server iga seda toetava tööriistaga — Claude Code, Codex, Cursor ja teised.
Mida agent näeb?
Numera MCP server pakub järgmisi tööriistu:
| Tööriist | Mida teeb |
|---|---|
list-projects |
Sinu ettevõtte projektide nimekiri koos staatuste ja mahtudega |
get-project |
Ühe projekti ülevaade: kirjeldus, liikmed, epicud, faasid koos tunnieelarvega, sprindid, staatused, tegevuse liigid (Arendus, Koosolek …) |
list-tasks |
Projekti ülesanded, filtreeritavad sprindi, epicu, faasi, staatuse või otsingu järgi |
get-task |
Ühe ülesande täisvaade: kirjeldus, tähtajad, vastutajad, tegevuse liik, ajakirjed, kommentaarid |
list-project-documents |
Projekti dokumentide kataloog (lepingud, pakkumised, märkmed) |
read-project-document |
Ühe dokumendi tekstisisu (PDF, DOCX, XLSX ja tekstifailidest) |
get-project-feed |
Projekti seina postitused ajalises järjekorras koos manuste loeteluga |
Kirjutusõigusega võtmega lisanduvad tööriistad:
| Tööriist | Mida teeb |
|---|---|
create-epic / update-epic |
Loob uue epicu või muudab olemasolevat (nimi, kirjeldus, värv, staatus) |
create-phase / update-phase |
Loob uue faasi (MVP, Faas 2 — algus, lõpp, tunnieelarve) või muudab olemasolevat |
create-task / update-task |
Loob uue ülesande (soovi korral epicusse, faasi või sprinti, koos staatuse ja tegevuse liigiga) või muudab olemasolevat — sh tõstab selle faasi (phase_id) või määrab tegevuse liigi (activity_id) |
create-sprint / update-sprint |
Loob uue sprindi või muudab plaanitud/aktiivse sprindi nime, kuupäevi ja eesmärki |
add-comment |
Postitab kommentaari projekti seinale või konkreetsele ülesandele |
log-time |
Logib ülesandele tööaega (kuupäev, kestus, kirjeldus, tegevuse liik) — vaikimisi arveldatav ja tehtuks märgitud. Vaikimisi logitakse aeg sinu enda nimele; ettevõtte omanik või raamatupidaja saab logida aega ka teisele projekti liikmele |
update-time-entry |
Muudab olemasolevat ajakirjet (kuupäev, kestus, kirjeldus, tegevuse liik, tehtud-staatus) — iga muudatus vajab enne salvestamist sinu kinnitust: esimene kutse tagastab eelvaate, salvestamine toimub alles kinnitusega |
delete-time-entry |
Kustutab ajakirje (näiteks ekslikult logitud või topelt kirje) — sama eelvaate ja kinnituse käik nagu muutmisel. Enda kirjeid saab kustutada igaüks, teiste omi projektijuht; arveldatud kirjed on lukus |
Ülesannetele viitab agent samade võtmetega, mida näed Numeras (näiteks SEPPS-53).
Pakkumised
Pakkumiste moodul on võtmel eraldi õigus — anna see ainult siis, kui agent peab pakkumisi nägema või koostama.
| Tööriist | Mida teeb |
|---|---|
list-quotes |
Pakkumiste ja projektipakkumiste nimekiri: number, pealkiri, klient, staatus, summa |
get-quote |
Ühe pakkumise täisvaade — projektipakkumisel faasid, tööpaketid, sektsioonid, küsimused ja vahemiku kokkuvõte samal kujul, mida update-quote vastu võtab |
get-quote-catalog |
Mida agent enne koostamist teadma peab: tööpakettide liigid, müügi käibemaksu koodid, vaikeväärtused, sektsioonide liigid |
get-quote-feedback |
Mis pärast saatmist juhtus: saajate avamised, kliendi vastused küsimustele, vastuvõtmine või tagasilükkamine |
Kirjutusõigusega lisanduvad:
| Tööriist | Mida teeb |
|---|---|
create-quote |
Koostab projektipakkumise mustandi: pealkiri, klient, faasid, tööpaketid (tunnivahemik × tunnihind või fikseeritud hind, valikulised paketid ja variandid), Markdownis kirjutatud sektsioonid, küsimused |
update-quote |
Muudab päiseväljasid või asendab kogu dokumendi keha; vastuvõetud pakkumist ei muuda |
add-quote-recipient |
Lisab saaja, et sinul jääks vaid saatmine |
Turvalisus
- Isiklik ligipääsuvõti — iga võti on seotud sinu kasutaja ja ühe konkreetse ettevõttega. Agent näeb täpselt neid projekte, mida sina näed: kui projekt on nähtav ainult liikmetele ja sa ei ole liige, ei näe seda ka agent.
- Õiguste tase sinu kontrolli all — lugemisõigusega võti ei luba ühtegi muudatust; kirjutusõigus tuleb võtme loomisel eraldi valida. Kustutamise tööriistu serveril ei ole.
- Krüpteeritud ühendus — kogu liiklus käib üle HTTPS-i.
- Võtme saab igal hetkel tühistada — tühistamine jõustub kohe.
- Võtit näidatakse ainult üks kord — Numera ei salvesta võtit avatekstina.
Ühendamine
1. osa — Ligipääsuvõtme loomine Numeras (Claude Code, Cursor jt)
- 1
Ava integratsioonide leht
Numera menüüst vali Integratsioonid ja otsi üles Numera MCP kaart.
- 2
Loo ligipääsuvõti
Vajuta Ühenda, anna võtmele nimi (näiteks projekti või seadme järgi), vali kehtivusaeg ja õigused — millistele moodulitele võti ligipääsu annab. Võti ei anna kunagi rohkem õigusi, kui sul endal Numeras on.
- 3
Kopeeri võti kohe
Võtit näidatakse ainult üks kord. Kopeeri nii võti kui ka ühendamise käsk enne akna sulgemist.
2. osa — Agendi ühendamine
- 1
Claude Code
Käivita oma projekti kaustas Numeras kuvatud ühendamise käsk:
claude mcp add --transport http numera https://numera.ee/mcp \ --header "Authorization: Bearer <sinu-võti>" - 2
Claude'i äpp ja veeb (claude.ai)
Claude ühendub OAuth-iga — ligipääsuvõtit pole vaja, piisab serveri aadressist.
- Ava Claude'is Settings → Connectors ja vajuta Add custom connector. Organisatsiooni puhul: Admin settings → Connectors.
- Kleebi aadressiväljale
https://numera.ee/mcpja kinnita. - Claude suunab sind Numerasse sisse logima — vali ettevõte ja õigused ning vajuta Luba ligipääs.
- 3
ChatGPT
- Veendu, et developer mode on lubatud, ja ava Settings → Apps & Connectors → Create.
- Kleebi MCP serveri aadressiks
https://numera.ee/mcpja kinnita. - ChatGPT suunab sind Numerasse sisse logima — vali ettevõte ja õigused ning luba ligipääs.
- 4
Muu MCP-toega agent (Codex, Cursor jt)
Lisa oma tööriista seadetes HTTP MCP server:
- Aadress:
https://numera.ee/mcp - Päis:
Authorization: Bearer <sinu-võti>
Täpse seadistuskoha leiad oma tööriista juhendist — enamik levinud agente (Claude Code, Codex, Cursor) toetab HTTP MCP servereid.
- Aadress:
- 5
Proovi järele
Küsi agendilt näiteks: "Vaata Numera MCP kaudu, millised ülesanded on projekti SEPPS aktiivses sprindis."
Võtmete haldamine
Kõiki oma võtmeid ja OAuth-ühendusi (Claude, ChatGPT) näed Integratsioonid → Numera MCP all: millal võti on loodud, millal viimati kasutatud ja millal aegub. Sealtsamast saad võtme või ühenduse tühistada — ligipääs kaob kohe.
Kui kahtlustad, et võti on lekkinud, tühista see ja loo uus.
Piirangud
- Lugemisõigusega võti ei luba andmeid muuta; kirjutusõigusega võti lubab luua ja muuta projektihalduse sisu (ülesanded, epicud, sprindid, kommentaarid) ja pakkumiste mustandeid. Kustutamine ja pakkumise saatmine käivad alati Numeras.
- Projektide omahind, eelarved ja kasumlikkus ei ole MCP kaudu kättesaadavad; pakkumiste moodul näitab ainult pakkumise enda hindu.
- Dokumentide tekst loetakse PDF, DOCX, XLSX ja tekstifailidest; piltidest (nt pildistatud leping) teksti ei loeta.
- Väga pikad dokumendid tagastatakse lühendatult — agent näeb, kui tekst on lühendatud.