> ## Documentation Index
> Fetch the complete documentation index at: https://docs.izumi.akiaconsulting.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> Povežite Izumi sa Slackbotom. Korake dele Izumi administrator, Slack administrator i svaki korisnik.

Provereno na Izumi 0.5.2 (razgovor sa Slackbotom, 2026-11-19) i na Izumi 0.5.7 (ekrani Izumija, 2026-11-20). Slack workspace na Free planu, Slackbot u Preview fazi.

Slackbot može da pita Izumi umesto korisnika. Svaka osoba povezuje svoj Izumi nalog, pa Slackbot vidi samo ono što ta osoba sme da vidi.

## Šta dobijate

* Pretraga dokumenata, čitanje dokumenta i "ko šta zna" iz Slackbota.
* Alati u Slackbotu: **Whoami**, **Search**, **Get document** i **Who knows**, a uz pravo `propose` i predlaganje beleške (`propose_note`).
* Dokument otpremljen u Izumi (upload, beleška) dobija link na svoju stranicu u Izumi. Dokument iz Google Drive-a zadržava link na originalni izvor.

## Ko šta radi

| Uloga | Koraci | Koliko puta |
| - | - | - |
| Izumi administrator | Korak 1 | Jednom po instalaciji Izumija |
| Slack administrator | Koraci 2 do 5 | Jednom po workspace-u |
| Svaki korisnik | Korak 6 | Jednom po osobi |

## Pre nego što počnete

* Izumi 0.5.2 ili noviji sa uključenim OAuth-om (administrator to podešava na serveru, vidi tab **Instalacija**).
* Administrator Izumija sa pristupom serveru.
* Slack workspace u kojem možete da pravite aplikacije. Free plan je dovoljan. Slackbot MCP je u Preview fazi.
* Slack nalog koji sme da instalira aplikaciju: vlasnik ili administrator workspace-a, ili uz odobrenje administratora.
* Adresa Izumija. U ovom uputstvu je `https://izumi.akiaconsulting.com`.

## Korak 1: registrujte Slack kao klijenta u Izumi (Izumi administrator)

Slack ne može sam da se registruje u Izumi (automatska registracija ne radi, vidi "Ograničenja"). Zato administrator jednom ručno pravi javnog klijenta. Na serveru, u folderu Izumija:

```
./tb admin oauth client add --label "Slackbot (naziv vašeg workspace-a)" --redirect-uri https://oauth2.slack.com/external/auth/callback
```

* Komanda ispiše `client_id`. Sačuvajte ga, treba vam u koraku 3.
* Ovo je javni klijent: nema `client secret`. Zaštitu daje PKCE.
* Redirect adresa mora biti tačno `https://oauth2.slack.com/external/auth/callback`.
* Provera: `./tb admin oauth client list` prikazuje klijenta. `./tb admin oauth client remove <client_id>` ga uklanja.

## Koraci 2 do 5 (Slack administrator)

### Korak 2: napravite Slack aplikaciju

Preporuka: posebna aplikacija samo za Izumi, da ne deli bot token sa drugim alatima.

**1. Otvorite Create New App**

Otvorite `https://api.slack.com/apps` i kliknite **Create New App**. U prozoru pod **From scratch** izaberite **Pick features**.

![Slack, Create new app](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/01-create-new-app.png?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=bf7a4bfec909144c05d6d2f30be3258b)

**2. Ime i workspace**

Upišite ime (na primer `Izumi`), izaberite workspace i kliknite **Continue**.

![Slack, ime aplikacije i workspace](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/02-app-name-workspace.png?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=83e17b85ad336e9cefb268c0b195e2ef)

**3. Dodajte scope mcp:connect**

U koraku "What it can do in Slack" u pretragu upišite `mcp:connect` i izaberite ga kao **bot scope**. To je jedini scope koji treba.

![Slack, pretraga scope-a](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/03-scope-search.png?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=8320858a814e34c7be1da84da6210535)

![Slack, dodat scope mcp:connect](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/04-scope-added.png?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=faca645cfb24bfc20901959608d1b72e)

**4. Završite pravljenje**

U koraku "What it can respond to" ništa ne dodajete, kliknite **Continue**. U pregledu piše **What it can do in Slack (1)**. Kliknite **Create and Install**.

![Slack, pregled aplikacije](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/05-review-app.png?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=53f5c3a2d8a5bcc43d75d9a97bac2fcc)

Ako dugme ostane sivo duže od očekivanog, otvorite `https://api.slack.com/apps`. Aplikacija je verovatno već napravljena.

### Korak 3: dodajte Izumi kao MCP server u aplikaciji

**1. Otvorite MCP Servers**

U aplikaciji otvorite **MCP Servers** u levom meniju i kliknite **Get Started** (ili **Add MCP Server** ako već postoji neki).

![Slack, lista MCP servera](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/06-mcp-servers-list.png?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=602e63b0229207e9d612b51750558a5a)

**2. Popunite formu**

Slack automatski dodaje bot scope `mcp:connect`.

| Polje | Vrednost |
| - | - |
| Name | `Izumi` |
| URL | `https://izumi.akiaconsulting.com/mcp` |
| Auth type | **Manual OAuth** (ne "Dynamic Client Registration") |
| Client ID | `client_id` iz koraka 1 |
| Client Secret | prazno |
| Authorization URL | `https://izumi.akiaconsulting.com/oauth/authorize` |
| Token request URL | `https://izumi.akiaconsulting.com/oauth/token` |
| Use HTTP Basic Authentication | isključeno |
| Use PKCE | uključeno (obavezno) |
| OAuth scopes | `read` i `propose` (svaki potvrdite sa Enter) |
| Identity URL, Account Identifier, Custom headers | prazno |

![Slack, forma MCP servera, gornji deo](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/07-mcp-form-top.png?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=fbdb333ea7ff3dff9d0d29c1e6cdea3f)

![Slack, forma MCP servera, donji deo](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/08-mcp-form-bottom.png?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=64caf4128e3ead804ce70d27300d19e5)

`read` je čitanje (pretraga, dokumenti), `propose` omogućava predlaganje beleški na pregled. Ako `propose` ne treba, ostavite samo `read`.

**3. Sačuvajte**

Kliknite **Save**. Pojavljuje se žuta traka "reinstall your app". To je sledeći korak.

### Korak 4: instalirajte aplikaciju (ponovo) u workspace

**1. Reinstall**

Kliknite **reinstall your app** u žutoj traci, ili otvorite **Install App** i kliknite **Reinstall to** (ime workspace-a).

**2. Dozvolite**

Slack prikazuje "Allow Izumi to access Slack" sa porukom "Perform actions in your workspace". Kliknite **Allow**. Posle toga se **Izumi** pojavljuje u Slacku pod **Apps** u levom meniju.

![Slack, Allow Izumi to access Slack](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/10-install-consent.png?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=56a62691618838c8b9d8506a938c5652)

Svaka izmena MCP servera traži novo **Reinstall**. Stranica **Install App** prikazuje bot token (počinje sa `xoxb`). To je tajna: ne delite je i ne stavljajte je u slike ni u uputstva. Na slici je token prekriven.

![Slack, Install App, token prekriven](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/17-slack-install-app.png?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=0a6f71d5f0c6e7cbe2fa4a3ae9c6e854)

### Korak 5: izgled aplikacije (opciono)

U **Basic Information**, odeljak **Display Information**: ime, kratak opis (na primer "Izumi team knowledge base for Slackbot"), ikona (znak sa orbitom, PNG 512 px ili veći) i boja pozadine. Ikona se vidi u Slackbotu kad traži dozvolu.

![Slack, Display Information](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/09-display-information.png?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=f493f5248f3cebfb7374116b363ebe9c)

## Korak 6: svaki korisnik povezuje svoj Izumi nalog

Svaka osoba ovo radi jednom.

**1. Pitajte Slackbot nešto o Izumi**

U panelu Slackbot postavite pitanje koje pominje Izumi, na primer: "Preko Izumija: ko sam ja i kojim kompanijama imam pristup?"

**2. Kliknite Connect**

Slackbot prikazuje karticu "Connect your Izumi account to continue" sa dugmadima **Don't ask again**, **Not now** i **Connect**. Kliknite **Connect**.

![Slackbot, kartica Connect your Izumi account](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/15-slackbot-connect-card.jpg?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=d4102708b60f9be76d0a1219d4cc869a)

**3. Nastavite ka Izumi**

Otvara se nova kartica: "You are about to connect to an external service", sa vašim Slack nalogom. Kliknite **Continue to Izumi**.

![Slack, ekran spoljne usluge](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/16-slack-external-service.jpg?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=e7896eceee0eb5f23f8cecc4eec1f0de)

**4. Prijavite se u Izumi**

Ako niste prijavljeni, Izumi prvo prikazuje prijavu. Prijavite se nalogom kojim se inače prijavljujete.

![Izumi, prijava](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/18-izumi-login.png?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=fd52f7793cda0d4c2f1886bb470df2e2)

**5. Odobrite vezu**

Izumi prikazuje stranicu "Poveži (naziv klijenta) sa Izumijem". Naziv je onaj koji je administrator dao klijentu u koraku 1.

* Upozorenje da ime aplikacije dolazi iz same aplikacije i nije potvrđeno, i da se posle odobravanja vraćate na `oauth2.slack.com`.
* **čita dokumente koje vi možete da čitate, u svim vašim firmama** (uvek uključeno) i **predlaže beleške koje pregleda urednik** (kvačica, možete da je isključite).
* Veza traje 90 dana.
* Kliknite **Odobri**.

![Izumi, stranica za odobravanje veze sa Slackbotom](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/13-izumi-consent.png?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=b50fe6d7f36f91c2a3007dfa9ecbf80b)

**6. Dozvolite alat**

Kartica se zatvara, vraćate se u Slack i pitanje se nastavlja. Pri prvom pozivu alata Slackbot traži dozvolu (**Whoami**, **Search**): **Allow Once** (samo ovaj put), **Always Allow** ili **Don't Allow**. Za početak izaberite **Allow Once**.

![Slackbot, dozvola za alat](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/12-slackbot-allow-tool.jpg?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=bd55f5c201b8647434c3e6bd772936d5)

**7. Pročitajte odgovor**

Slackbot odgovara sa linkom na dokument u Izumi.

![Slackbot, odgovor sa linkom na dokument](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/11-slackbot-answer.png?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=81e455cfed6302a5edc5eb849b88e16f)

Primeri pitanja:

* "Preko Izumija: pronađi dokument o (tema) i daj mi link."
* "Preko Izumija: ko u firmi zna o (tema)?"
* "Preko Izumija: predloži belešku u domen (domen) sa naslovom (naslov) i tekstom (tekst)."

### Predlog beleške iz Slackbota

Predlaganje je proveravano uživo (Izumi 0.5.2, 2026-11-19). Predlog se pojavio u **Red za pregled**, sa klijentom čiji je naziv onaj iz koraka 1, i urednik domena ga je odbio sa razlogom. Za odobravanje i odbijanje vidi stranicu ChatGPT, odeljak o predlogu u Izumi.

## Pregled i opoziv

U Izumi otvorite **Moji tokeni i profil**, odeljak **Tokeni**. Povezana aplikacija je red **Povezana aplikacija** sa pravima (`read`, `propose`), datumom isteka i poslednjom upotrebom. **Opozovi** prekida vezu.

![Izumi, Moji tokeni i profil sa vezom Slackbot](https://mintcdn.com/akia-consulting/-l5XLI7ftc2U1SZX/images/sr/slack/14-izumi-my-tokens.png?fit=max\&auto=format\&n=-l5XLI7ftc2U1SZX\&q=85\&s=e2155f5a6c95858bccf708bcb775d727)

> [!WARNING]
>
> Posle opoziva Slackbot (Preview) ne zna da je veza opozvana. Kartica za dozvolu alata ostaje, dugme **Allow Once** ne radi ništa, bez greške i bez ponude za ponovno povezivanje. Slack nema dugme za prekid veze na strani korisnika. Radi ovo (provereno 2026-11-19): u Slack aplikaciji **Izumi** otvorite **MCP Servers**, uklonite server, dodajte ga ponovo sa istim vrednostima (korak 3) i reinstalirajte aplikaciju (korak 4). Slackbot tada ponovo prikazuje karticu **Connect**. Verovatno ovo važi za sve korisnike workspace-a, jer je veza vezana za aplikaciju (to nije proveravano posebno).

## Ograničenja

| Šta | Detalji |
| - | - |
| Automatska registracija ne radi | Slack šalje `token_endpoint_auth_method=client_secret_post`. Izumi prihvata samo `none` i `private_key_jwt`, pa Slack javlja "Automatic registration did not go through". Zato je klijent ručni (korak 1). |
| Slackbot Preview ima limit poruka | Panel prikazuje "N messages left in your preview". Odgovoren upit troši jednu poruku, zahtev za povezivanje ne. Šta se dešava kad se potroše nije potvrđeno. |
| Link na otpremljeni dokument traži prijavu | Link se otvara u Izumi posle prijave. Slackbot ne može da ga otvori umesto korisnika. |
| Ograničeni dokumenti | Slackbot vidi samo ono što korisnik sme. Za dokument sa oznakom ograničenja (na primer HR) odgovor kaže ko sme da ga čita. |
| Dokument sa izvorom | Link je izvorni link (na primer Drive). Ako korisnik nema pristup izvoru, link mu ne vredi. Izumi stranica je tada alternativa. |
| Svaka izmena MCP servera | Traži novo **Reinstall**. |

> [!WARNING]
>
> Slike Slack ekrana su iz stanja 2026-11-19. Slack menja izgled Preview funkcije, pa se ekrani mogu razlikovati. Razgovor sa Slackbotom (kartica Connect, dozvola, odgovor) nije ponovljen na Izumi 0.5.7: pokušaj 2026-11-21 nije bio moguć jer je Slackbot Preview za probni Free workspace istekao ("Your Slackbot preview ended"), pa je poslednja živa provera razgovora ostala na Izumi 0.5.2. Probani su samo Free plan i Preview, a drugi planovi nisu.

## Rešavanje problema

| Simptom | Uzrok i rešenje |
| - | - |
| Slackbot ne pominje Izumi alate | Aplikacija nije reinstalirana posle izmene MCP servera (korak 4). Proverite da je **Izumi** pod **Apps**. |
| "Connect" otvara grešku o redirect adresi | Redirect klijenta u Izumi nije `https://oauth2.slack.com/external/auth/callback` (korak 1). |
| Izumi odbija `client_id` | Pogrešan ili uklonjen klijent. `./tb admin oauth client list`. |
| Greška pri razmeni koda (token) | Isključite "Use HTTP Basic Authentication", uključite PKCE, ostavite Client Secret prazan. |
| Alati rade, ali nema dokumenata | Korisnik nema pristup kompaniji ili domenu u Izumi. `whoami` pokazuje kompanije i uloge. |
| Dugo nema odgovora | Proverite `https://izumi.akiaconsulting.com/readyz`. Administrator na serveru gleda log aplikacije. |
| Slack javlja "Something went wrong" pri pravljenju aplikacije | Sačekajte i probajte ponovo. Ako traži "creating apps too quickly", sačekajte. |
| Cancel na ekranu "Allow Izumi to access Slack" | Slack prikazuje "Something went wrong when authorizing". To je normalno ponašanje odbijanja, postojeća instalacija se ne menja. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.