Připojte AI k ALITEO.

1Krok 1Správce povolí MCP ve společnosti

Tento krok může provést pouze správce (administrátor) společnosti a stačí ho provést jednou.

1. Otevřete Nastavení společnosti › Integrace › MCP konektor.
2. U položky MCP klient zapněte přepínač. Stav se změní na Povoleno.
3. V části Oprávnění nastavte, co smí AI ve společnosti dělat:
   • Čtení – úkoly, projekty, výkazy práce,
   • Čtení a zápis – navíc vytváření a úprava úkolů a výkazů práce,
   • Kompletní správa – navíc administrátorská sekce.
4. Dejte uživatelům vědět, že je připojení povolené.

Nastavená oprávnění jsou strop. Uživatel je při přihlášení může pouze zúžit, nikdy rozšířit.

2Krok 2Uživatel si najde údaje pro připojení

Klikněte v ALITEO na své jméno a otevřete MCP konektor. V části MCP klient najdete dva údaje, které budete potřebovat:

• Adresa serveru – https://api.aliteo.com/mcp
• ID klienta – 6b628c55-da54-4281-8cd7-14c8a1b063f7

Oba údaje jsou stejné pro všechny uživatele ALITEO. V aplikaci je zkopírujete i ikonou vedle pole.

Na stejné obrazovce vidíte, ve kterých společnostech správce připojení povolil (např. Povoleno: 1 z 3). V části Relace najdete seznam svých přihlášení AI asistenta, akce, které v nich provedl, a můžete je kdykoli odpojit.

3Krok 3Přidejte ALITEO do svého AI asistenta

Claude (Free, Pro, Max)

1. V Claude otevřete Customize › Connectors.
2. Klikněte na + Add › Add custom connector.
3. Zadejte název ALITEO a adresu serveru https://api.aliteo.com/mcp.
4. Vložte ID klienta z ALITEO jako OAuth client ID. Podle podoby dialogu je pole v Advanced settings, nebo v části OAuth client zvolte Use your own OAuth client. Client secret nechte prázdný.
5. Klikněte na Add a poté na Connect.
6. Přihlaste se do ALITEO a na obrazovce se souhlasem potvrďte oprávnění.
7. V chatu klikněte na + › Connectors a zapněte ALITEO.

Na plánu Free můžete mít jeden vlastní konektor.

Claude (Team, Enterprise)

Vlastní konektor přidává pouze vlastník organizace Claude (Owner). V Organization settings › Connectors zvolí Add › Custom › Web a zadá adresu serveru a ID klienta jako výše. Členové pak v Customize › Connectors kliknou u ALITEO na Connect a každý se přihlásí svým účtem ALITEO.

ChatGPT

Vlastní MCP servery jsou v ChatGPT dostupné v placených plánech přes Developer mode ve webové aplikaci chatgpt.com. V plánech Business a Enterprise je musí nejprve povolit správce pracovního prostoru.

1. Otevřete Settings › Apps & Connectors › Advanced settings a zapněte Developer mode.
2. V Apps & Connectors klikněte na Create a zvolte vlastní MCP server. Otevře se formulář Přidat vlastní server MCP.
3. Zadejte název ALITEO. U připojení ponechte Adresa URL serveru a zadejte https://api.aliteo.com/mcp. Ověřování ponechte OAuth.
4. Otevřete Pokročilé nastavení OAuth. Způsob registrace ponechte Uživatelem definovaný klient OAuth a do pole ID klienta OAuth vložte ID klienta z ALITEO. Tajný klíč nechte prázdný. Ostatní pole ChatGPT vyplní sám.
5. V sekci PKCE zaškrtněte Server podporuje PKCE (S256).
6. Zaškrtněte Rozumím a chci pokračovat a klikněte na Vytvořit jako plugin.
7. Přihlaste se do ALITEO a potvrďte oprávnění.

Claude Code (příkazový řádek)

V terminálu spusťte:

claude mcp add --transport http --scope user --client-id 6b628c55-da54-4281-8cd7-14c8a1b063f7 ALITEO https://api.aliteo.com/mcp

Poté v Claude Code zadejte /mcp, vyberte ALITEO a přihlaste se do ALITEO v prohlížeči. Volba --scope user zpřístupní ALITEO ve všech Vašich projektech.

Konfigurace v JSON (Claude Code a jiné MCP klienty)

Pokud klient používá konfigurační soubor (např. .mcp.json v projektu pro Claude Code), přidejte do části mcpServers:

{
  "mcpServers": {
    "aliteo": {
      "type": "http",
      "url": "https://api.aliteo.com/mcp",
      "oauth": {
        "clientId": "6b628c55-da54-4281-8cd7-14c8a1b063f7"
      }
    }
  }
}

Jiný MCP klient musí umožnit zadat vlastní OAuth client ID, protože ALITEO nepodporuje automatickou registraci klienta. Při prvním použití se otevře prohlížeč, přihlaste se do ALITEO a potvrďte oprávnění.

4Krok 4Vyzkoušejte připojení

Připojení funguje, když AI vrátí Vaše skutečné úkoly. Zkuste například:

• „Jaké úkoly mám v ALITEO po termínu?“
• „Shrň stav projektu … a napiš, co je ohrožené.“
• „Založ v ALITEO úkol … s termínem v pátek a přiřaď ho mně.“ (vyžaduje oprávnění Čtení a zápis)

Vše, co AI v ALITEO udělá, uvidíte v aktivitách úkolu pod Vaším jménem.

1Krok 1Přidejte agenta

1. Otevřete Nastavení společnosti › AI agenti a klikněte na + Přidat.
2. Zadejte Název agenta, například Agent support, a klikněte na Přidat AI agenta.
3. Agent se zobrazí v seznamu. Kliknutím otevřete jeho detail.

2Krok 2Určete, kdo může agenta zmínit

V detailu agenta v části Kdo může agenta zmínit (@) zvolte:

• Všichni interní členové, nebo
• Vybraní členové – agenta mohou zmínit pouze lidé, které přidáte, nikdo jiný.

Správci společnosti mohou agenta zmínit vždy, externí členové nikdy. Protože zmínkou agent získá přístup k úkolu, vybírejte lidi uváženě.

3Krok 3Zapněte přístup agenta do ALITEO

1. V části Přístup agenta do ALITEO zapněte Agent používá vlastní MCP konektor.
2. Zkopírujte adresu Server (https://api.aliteo.com/mcp-agents/…). Každý agent má vlastní.
3. Vyberte způsob ověření:
   • Client ID (OAuth) – doporučujeme. Je stejné pro všechny: 6b628c55-da54-4281-8cd7-14c8a1b063f7. V Claude se přihlásíte účtem správce společnosti a ze seznamu agentů vyberete tohoto agenta. Přihlášení platí 180 dní. Pokud konektor 90 dní nepoužijete, vyprší dříve.
   • API klíč – u První API klíč klikněte na Vytvořit klíč a hned si ho bezpečně uložte. Druhý API klíč slouží k výměně bez výpadku: vytvořte druhý, přepněte na něj službu a první zrušte.

4Krok 4Připojte agenta v Claude

1. V Claude otevřete Customize › Connectors a klikněte na + Add › Add custom connector. Na plánech Team a Enterprise přidává konektor vlastník organizace v Organization settings › Connectors.
2. Zadejte název, například ALITEO – Agent support, a adresu Server agenta z kroku 3.
3. Při OAuth: vložte Client ID agenta jako OAuth client ID (v Advanced settings nebo přes Use your own OAuth client). Client secret nechte prázdný. Klikněte na Add a Connect, přihlaste se účtem správce společnosti a vyberte agenta.
4. Při API klíči: zvolte přihlášení No sign-in a v Request headers přidejte hlavičku authorization s hodnotou Bearer (s mezerou) a za ní API klíč. Hlavičky jsou v Claude zatím beta a nemají je všechny účty.

5Krok 5Vytvořte rutinu v Claude

1. V Claude Code vytvořte novou rutinu.
2. Jako konektor jí ponechte pouze konektor agenta z kroku 4.
3. Do pokynů napište, co má agent dělat. Pokud ho bude spouštět webhook, uveďte výslovně, že má zpracovat událost, kterou dostane z ALITEO (například číslo úkolu a text komentáře).
4. Nastavte spouštění:
   • Časový plán – například každé 2 hodiny. Webhook v ALITEO pak není potřeba.
   • API trigger – pro spouštění z ALITEO. Zkopírujte jeho URL a token.

Firemní agenty doporučujeme vytvářet na samostatném firemním účtu Claude. Rutiny i tokeny pak při odchodu zaměstnance zůstanou ve firmě.

6Krok 6Nastavte webhook v ALITEO

Tento krok potřebujete pouze tehdy, pokud má ALITEO spouštět agenta na událost.

1. V detailu agenta v části Kdy ALITEO zavolá agenta (webhook) klikněte na + Přidat webhook.
2. Obecné: ponechte stav Aktivní, zadejte název a u metody POST vložte do URL adresa URL API triggeru rutiny.
3. Události: v Typy akcí vyberte, kdy se má agent spustit, například Vytvoření úkolu, Vytvoření projektu, Přidání úkolu k reakci nebo Zmínka uživatele v komentáři. Poté omezte rozsah na pracovní prostory, projekty nebo týmy.
4. Pokročilé: klikněte na Přednastavit webhook › Rutina Claude. ALITEO doplní hlavičku i obsah požadavku. V části Tajný údaj upravte položku Authorization a jako hodnotu vložte token rutiny.
5. Klikněte na Uložit změny.

Pro agenta v ChatGPT zvolte Přednastavit webhook › Agent ChatGPT. Údaje zkopírujete z nastavení agenta v ChatGPT.

Tyto webhooky patří pouze agentovi. Obecné webhooky najdete v Nastavení společnosti › Integrace.

7Krok 7Vyzkoušejte agenta

• Webhook: vyvolejte zvolenou událost, například v úkolu napište komentář se zmínkou agenta. Agent výsledek zapíše do úkolu pod svým jménem.
• Časový plán: spusťte rutinu v Claude ručně a zkontrolujte, co agent zapsal v ALITEO.