← Sva dokumentacija

Povežite Integral

MCP server

Poslednja izmena: 28. septembar 2026.

Integral govori Model Context Protocol, pa AI klijent koji već koristite može da radi u vašem radnom prostoru: pretražuje bazu znanja, čita i piše dokumente, pokreće tokove i agente, vuče izveštaje i tabele, a administratorima — i da upravlja konektorima, ljudima, podešavanjima i troškom.

Jedna adresa i jedno pravilo: klijent nastupa kao član koji ga je odobrio i ne može više nego što ta osoba može u aplikaciji. Nema servisnog naloga ni ključa za ceo radni prostor.

Adresa

URL
https://integral.meteorit.rs/api/mcp
Transport
Streamable HTTP, revizija protokola 2025-06-18
Prijava
OAuth 2.1 sa dinamičkom registracijom i PKCE, ili mk_ API ključ poslat kao bearer token
Otkrivanje
/.well-known/oauth-protected-resource i /.well-known/oauth-authorization-server
Sesije
Nema ih. Svaki zahtev iznova razrešava kredencijal, pa opozvano ovlašćenje prestaje da važi već pri sledećem pozivu, a ne po isteku keša.
Radni prostor
Određuje ga kredencijal. Ako ste u dva radna prostora, povežete se dva puta.

Podešavanje

Svi klijenti ispod gledaju na istu adresu. Gde god klijent nudi dugme za povezivanje, izaberite OAuth: ovlašćenje se veže za vas, vidite ekran saglasnosti i možete ga opozvati sa obe strane.

Claude — web, desktop i Cowork

Jedna lista konektora, zajednička za sva tri. Dodaje se jednom.

  1. 1U Claude-u otvorite Settings → Connectors → Add custom connector i nalepite adresu.
    https://integral.meteorit.rs/api/mcp
  2. 2Claude se sam registruje i šalje vas na Integral. Prijavite se ako već niste.
  3. 3Ekran saglasnosti navodi radni prostor, vas kao člana i ovlašćenja koja se traže. Odobrite i alati se pojave u klijentu.

Claude Code

Dodaje se po projektu, ili sa --scope user za sve projekte.

  1. 1Dodajte server iz terminala:
    claude mcp add --transport http integral https://integral.meteorit.rs/api/mcp
  2. 2Pokrenite /mcp u sesiji i izaberite Authenticate. Otvara se isti ekran saglasnosti.
    /mcp

Cursor, Windsurf i drugi klijenti sa konfiguracionim fajlom

Udaljeni MCP preko HTTP-a; klijent sam otvara OAuth pri prvoj upotrebi.

  1. 1Dodajte server u MCP konfiguraciju klijenta — u Cursor-u je to ~/.cursor/mcp.json:
    {
      "mcpServers": {
        "integral": {
          "url": "https://integral.meteorit.rs/api/mcp"
        }
      }
    }
  2. 2Ponovo učitajte klijent i odobrite ekran saglasnosti kada se otvori.

Grok i Grok Bot

Prilagođeni konektor na grok.com; prilagođeni MCP server u Grok Bot-u. Ceo postupak je u članku o Groku.

  1. 1Na grok.com otvorite Connectors → New Connector → Custom i nalepite adresu. U Grok Bot-u zatražite od bota da doda prilagođeni MCP server sa istom adresom.
    https://integral.meteorit.rs/api/mcp
  2. 2Prijavite se na Integral i odobrite ekran saglasnosti.

Skripte, CI i sve bez dugmeta za povezivanje

Koristite API ključ. Vezan je za jednog člana i jedan radni prostor, isto kao ovlašćenje.

  1. 1Administrator izdaje ključ u Settings → API keys, bira ovlašćenja i rok. Prikazuje se samo jednom.
  2. 2Pošaljite ga kao bearer token na istu adresu:
    Authorization: Bearer mk_…

Šta klijent sme

Svaki poziv određuju tri kruga, a rezultat nikada nije širi od najužeg: šta vi smete u radnom prostoru, šta je kredencijal dobio i šta sam alat dozvoljava. Posmatrač sa pravom upisa i dalje ne može da upisuje.

Ovlašćenja su grupisana kao i sama aplikacija, i odobravate ih po grupi na ekranu saglasnosti:

  • —Asistent — pitanja asistentu radnog prostora i pretraga baze znanja
  • —Dokumenti, izveštaji, tabele, kontrolna tabla — čitanje, i upis tamo gde ga već imate
  • —Tokovi i agenti — pregled, pokretanje i izmena
  • —Konektori — uvid u povežano i upravljanje (administratori)
  • —Ljudi, radni prostor, troškovi, dnevnik — tim, podešavanja, ograničenja troška i revizorski trag (administratori)

Šta radni prostor kontroliše

  • Svako ovlašćenje se vidi i može opozvati. Settings → API keys → Connected clients pokazuje svaki povežan klijent, čiji je i kada je poslednji put korišćen, sa opozivom po redu. Administratori vide sve, vi svoje.
  • Deaktiviranje osobe gasi i njene klijente. Pristup se čita iz živog članstva pri svakom zahtevu, pa nema naknadnog čišćenja koje se zaboravi.
  • Administrator može potpuno da isključi povezivanje za članove. Tada samo administratori mogu da povežu klijent, i ekran saglasnosti to i kaže umesto da odbije bez objašnjenja.
  • Radnje sa posledicama pitaju čoveka. Sve što šalje, briše ili troši vraća link za potvrdu umesto da odmah uradi, a čovek to odobrava.
  • Ograničenja broja poziva i troška idu po kredencijalu. Preko broja poziva dobijate 429 sa Retry-After; preko mesečnog budžeta kredencijala ili ograničenja radnog prostora — 402.

Kada ne radi

  • 401 na svaki poziv. Ovlašćenje je opozvano, ključ istekao ili je članstvo deaktivirano. Odgovor je namerno isti za sve — povežite klijent ponovo.
  • Alata nema umesto da javlja grešku. Vaša uloga ne doseže do njega. Alati vezani za ulogu se uklanjaju iz spiska, pa klijent i ne nudi ono što bi zatim bilo odbijeno.
  • 403 zbog ovlašćenja koje nedostaje. Kredencijal je dobio manje nego što alatu treba. Povežite se ponovo i odobrite tu grupu, ili tražite od administratora ključ sa njom.
  • Dugme za povezivanje odbija. Povezivanje za članove je isključeno za taj radni prostor. Administrator ga vraća u podešavanjima.