> ## 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. 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.