Ühenda AI-agendid MCP abil

Nola käitab Model Context Protocoli (MCP) serverit, et AI-agendid saaksid sellega otse suhelda. Igaühe agent saab otsida avalikustatud ettevõtteid, teenuseid, hindu ja vabu aegu. Sinu enda agent saab sinu nimel sisse logida ning vaadata sinu kalendrit ja kliente, ja kui sa seda lubad, siis teha, muuta ja tühistada broneeringuid ning muuta ressursse, teenuseid, nädalatunde ja hinnareegleid.

See töötab iga agendiga, mis toetab MCP-kaugservereid üle voogedastatava HTTP (Streamable HTTP), sealhulgas Claude'i, ChatGPT, Gemini, Groki, Cursori, VS Code'i, Microsoft Copilot Studio, Perplexity ja Mistral Le Chatiga.

#Kaks aadressi

Mõlemad aadressid on koos nupuga Kopeeri nähtaval jaotises Seaded → Integratsioonid → AI-agendid (MCP).

#Ühenda oma agent

Claude

1. Lisa Claude'is kohandatud pistikprogramm (custom connector) ja kleebi URL-iks https://getnola.co/api/mcp/provider.
2. Klõpsa Ühenda. Avaneb Nola sisselogimisleht.
3. Logi sisse oma Nola kontoga ja kinnita ligipääs.

Claude Code'is käivita see käsk ja kasuta sisselogimiseks käsku /mcp:

claude mcp add --transport http nola https://getnola.co/api/mcp/provider

ChatGPT

1. Lülita sisse arendajarežiim ja loo uus rakendus (connector) URL-iga https://getnola.co/api/mcp/provider.
2. Vali autentimiseks OAuth ja salvesta.
3. Logi oma Nola kontoga sisse, kui ChatGPT seda küsib.

ChatGPT põhjalik otsing (deep research) kasutab avalikke tööriistu search ja fetch, mis ei vaja sisselogimist.

Cursor, VS Code ja Gemini CLI

Lisa server kliendirakenduse MCP-seadistusse ja logi sisse, kui rakendus seda küsib.

Cursor (mcp.json):

{ "mcpServers": { "nola": { "url": "https://getnola.co/api/mcp/provider" } } }

VS Code (.vscode/mcp.json):

{ "servers": { "nola": { "type": "http", "url": "https://getnola.co/api/mcp/provider" } } }

Gemini CLI (settings.json):

{ "mcpServers": { "nola": { "httpUrl": "https://getnola.co/api/mcp/provider" } } }

Copilot Studio, Perplexity, Mistral Le Chat ja muud rakendused

Lisa MCP-kaugserver URL-iga https://getnola.co/api/mcp/provider ja vali OAuth. Rakendus seob end Nola sisselogimisega automaatselt.

Agendid, mis ei saa sisse logida: Grok API, OpenAI Responses API, n8n

Mõned agendid oskavad saata ainult püsivat tokenit. Loo vajalike õigustega API-võti ja edasta see bearer-tokenina aadressile https://getnola.co/api/mcp.

API-võtmed vajavad paketti Business või Enterprise. Teiste pakettide puhul lükatakse agendi võtmega tehtud päringud tagasi; enda kontoga sisselogimine (OAuth) töötab iga paketiga.

xAI Grok API:

{ "type": "mcp", "server_url": "https://getnola.co/api/mcp", "server_label": "nola", "authorization": "nola_live_…" }

OpenAI Responses API:

{ "type": "mcp", "server_label": "nola", "server_url": "https://getnola.co/api/mcp", "authorization": "nola_live_…", "require_approval": "always" }

Anthropic Messages API (MCP pistikprogramm):

{ "type": "url", "name": "nola", "url": "https://getnola.co/api/mcp", "authorization_token": "nola_live_…" }

#Mida sisselogitud agent teha saab

Agent saab samasuguse ligipääsu nagu sinu roll ettevõttes. Administraatori agent saab hallata broneeringuid ja kliente, kuid mitte seadeid; raamatupidaja agent ei näe kalendrit ega kliente. Töötajad, kelle ligipääs on piiratud nende endi ressurssidega, näevad ainult vastavaid broneeringuid, ja töötajad, kellel puudub ligipääs rahale, ei näe hindu. API-võtme puhul määravad õigused võtmele antud skoobid.

Kui kuulud mitmesse ettevõttesse, töötab agent vaikimisi esimeses. Palu tal kutsuda välja get_business_overview, mis loetleb sinu ettevõtted, ja anda ettevõtte nimeosa (slug) parameetrina workspace.

Lugemine

Muudatuste tegemine

Andmete importimine

Ettevõtte omaniku agent saab tuua andmed üle teisest süsteemist samamoodi nagu abilise import. Ainult omanik, sisselogituna: töötajad ja API-võtmed neid tööriistu ei saa. Agent saadab tabeli CSV-tekstina.

#Luba AI-agentidel muudatusi teha

Agendid saavad sinu ettevõtte andmeid ainult lugeda, kuni omanik lubab muudatused:

1. Ava Seaded → Integratsioonid ja otsi jaotist AI-agendid (MCP).
2. Lülita sisse lüliti valiku Luba AI-agentidel muudatusi teha kõrval.

Kui see on väljas, on muudatuste tegemise tööriistad agentide eest peidetud. Lülitit saab muuta ainult ettevõtte omanik. Omanik ja juhi rolliga meeskonnaliikmed saavad avada lehe Seaded → Integratsioonid ja seda jaotist näha, kuid juhid ei saa lülitit sisse lülitada. Meeskonnaliikmed, kelle ligipääs piirdub teatud asukohtade, ressursside või oma kalendriga, seda lehte ei näe.

Iga agendi tehtud muudatus salvestatakse auditilogisse koos kasutaja (või API-võtme looja) nime ja märkega, et see tehti MCP kaudu.

Kinnitused

reschedule_booking, cancel_booking, update_resource, update_service, set_weekly_hours, create_pricing_rule, update_pricing_rule, import_commit ja import_undo ei tee muudatust kohe esimesel väljakutsel. Need tagastavad muudatuse eelvaate ja kinnitustokeni. Agent peaks sulle eelvaadet näitama; muudatus jõustub alles siis, kui agent teeb uue päringu samade andmete ja tokeniga. Token kehtib 5 minutit ja ainult selle konkreetse muudatuse jaoks.

create_booking võtab vastu parameetri idempotencyKey. Kui agent kordab sama võtmega päringut 24 tunni jooksul, tagastab Nola esimese broneeringu uue loomise asemel.

#Mida saab vaadata igaühe agent

Ilma sisse logimata saavad agendid kasutada järgmisi tööriistu ettevõtete puhul, kellel on avalikustatud broneerimisleht:

Kliendid viivad broneerimise ja maksmise lõpule broneerimislehe lingil, mille agent neile annab.

#Kellaajad ja ajavööndid

Kõik kellaajad on vormingus ISO 8601 koos ajavööndi nihkega, näiteks 2026-10-01T09:00:00+03:00. Ilma nihketa aegu vastu ei võeta, et agent ei broneeriks kogemata valel kellaajal. get_business_overview ja check_availability tagastavad sinu ettevõtte ajavööndi.

#Piirangud

Piirangu ületamisel vastab Nola staatusega 429 ja päisega Retry-After.

#Arendajatele

• Protokoll: MCP 2026-07-28 üle voogedastatava HTTP (Streamable HTTP). Teenindatakse ka 2025. aasta protokolliversioonide kliente. Server seansse ei säilita.
• Sisselogimine: OAuth 2.1 koos PKCE-ga. Otspunkt vastab koodiga 401 koos päisega WWW-Authenticate, mis viitab aadressile /.well-known/oauth-protected-resource/api/mcp/provider. Kliendid registreeruvad dokumendiga Client ID Metadata Documents või lahendusega Dynamic Client Registration. Skoobid: openid profile email.
• Veateated tagastatakse tööriista tulemusena koos parameetriga isError: true ja loetava põhjendusega, et agent saaks end ise parandada.
• Teistelt veebilehtedelt tulevad brauseripäringud lükatakse tagasi.

Brauserites, mis toetavad WebMCP-d (navigator.modelContext), registreerivad Nola lehed mõned tööriistad ka brauseri sisseehitatud assistendile: list_industries, list_plans, search_help, list_providers, get_provider ja navigate (ainult avalikud lehed). list_plans tagastab pakettide nimed ja nende sisu ilma hindadeta, kuna Nola jagab hindu päringu alusel.

#Seotud teemad

• Loo API-võtmed ja veebihaagid
• REST API dokumentatsioon
• Tehisintellektiga Copilot
• Auditilogi
• Kutsu oma meeskond