Zdroje · Agenti
Připojte agenta AI.
Synteum má vzdálený server MCP pro klienty AI a REST API pro programy. Agent pracuje s vaším účtem, vidí jen to, co vidíte vy, a než cokoli smaže, zobrazí náhled.
Připojte klienta MCP
Přidejte vzdálený server https://mcp.synteum.com do klienta MCP, který podporuje OAuth 2.1 a dynamickou registraci klienta. Klient otevře přihlášení do Synteum. Přihlásíte se svým e-mailem a heslem Synteum, a pokud je zapnuté MFA, i jím, a klient dostane token.
- Koncový bod:
https://mcp.synteum.com - Přenos: Streamable HTTP, bezstavový, s odpověďmi JSON.
- Kontrola stavu:
https://mcp.synteum.com/healthz
Přihlášení a přístup
- Zjišťování: metadata chráněného prostředku (RFC 9728) na
https://mcp.synteum.com/.well-known/oauth-protected-resourcea metadata autorizačního serveru (RFC 8414) nahttps://mcp.synteum.com/.well-known/oauth-authorization-server. - Registrace: dynamická registrace klienta (RFC 7591) na
https://mcp.synteum.com/oauth/register. Adresy URI pro přesměrování používají https, nebo http na adrese loopback. - Tok: autorizační kód s PKCE S256. Autorizační požadavek uvádí prostředek
https://mcp.synteum.com. - Rozsahy:
synteum:readpro nástroje, které čtou,synteum:writepro nástroje, které mění data. Zápis zahrnuje čtení. Klient, který o žádný rozsah nepožádá, dostane oba. - Tokeny: přístupový token platí 15 minut a obnovovací token se při každém použití vymění. Oprávnění končí s vaší relací Synteum (nejvýše 7 dní nečinnosti a 30 dní celkem), když se odhlásíte, nebo když ho odvoláte.
- Přístup: agent jedná za vás. Vidí stejné pracovní prostory, má v každém stejnou roli a dostane se ke stejným projektům a nástěnkám. Server nepřidává žádná vlastní práva.
Pravidla, podle kterých agent pracuje
- Destruktivní nástroj při prvním volání nic nezmění. Vrátí náhled a agent ho zavolá znovu s
confirmaž poté, co souhlasíte. Smazání úkolu navíc vyžaduje verzi uvedenou v náhledu. - Každý zápis nese nový klíč idempotence, takže opakovaný pokus nikdy nevytvoří duplikát. Úprava nebo přesun odpoví
version_conflict, když položku mezitím změnil někdo jiný. - Nástroje přijímají volitelný pracovní prostor. Bez něj server použije váš jediný, nebo výchozí pracovní prostor.
synteum_workspace_selectnastaví výchozí. - Seznamy se vracejí po stránkách.
synteum_task_listvrací 1 až 50 úkolů na stránku, ve výchozím stavu 20, s kurzorem na další stránku. - Server omezuje volání každého uživatele, a když agent pošle příliš mnoho požadavků, odpoví 429 s hlavičkou Retry-After.
- Soubory se nahrávají v aplikaci. Server MCP nemá nástroj pro nahrávání.
Nástroje
Server nabízí 99 nástrojů. Každý název začíná synteum_, což seznamy níže vynechávají. Každý nástroj uvádí, zda data čte, nebo mění, a má vstupní a výstupní schéma.
Účet a pracovní prostory
whoami, workspace_list, workspace_select
Úkoly
task_list, task_search, task_get, task_create, task_create_many, task_update, task_move, task_archive, task_restore, task_delete
Komentáře, kontrolní seznamy a odkazy
comment_add, comment_list, comment_update, comment_delete, checklist_list, checklist_add, checklist_update, checklist_move, checklist_delete, link_list, link_add, link_remove
Přílohy
attachment_list, attachment_read, attachment_rename, attachment_delete
Čas a časové rámce
time_log, time_list, time_update, time_delete, time_report, timeframe_list, timeframe_create, timeframe_update, timeframe_delete
Štítky
tag_list, tag_create, tag_update, tag_delete
Projekty, nástěnky a sloupce
project_list, project_get, project_create, project_update, project_archive, project_restore, project_move, project_delete, board_list, board_get, board_create, board_update, board_move, board_delete, column_create, column_update, column_move, column_delete, board_export, board_import, board_clear
Týmy, členové a přístup
team_list, team_get, team_create, team_update, team_delete, team_restore, team_transfer, team_leave, team_settings_get, team_settings_update, team_member_list, team_member_add, team_member_update, team_member_remove, member_access_get, member_access_set
Pozvánky a kódy pro připojení
invitation_list, invitation_accept, invitation_decline, team_invitation_list, team_invitation_get, team_invitation_resend, team_invitation_revoke, join_code_create, join_code_list, join_code_revoke, join_code_redeem
Aktivita, upozornění a oznámení
activity_list, alert_list, alert_dismiss, portfolio_get, notification_list, notification_read, notification_read_all
Styl úkolů
convention_get, convention_set
REST API
Programy používají REST API pod https://synteum.com/v1. Program jedná s rolí účtu, kterým se přihlašuje, a vidí jen projekty a nástěnky, které vidí tento účet.
Strojově čitelné stránky
- llms.txt uvádí veřejné stránky pro jazykové modely.
- llms-full.txt obsahuje text všech veřejných stránek v jednom souboru Markdown.
- Každá veřejná stránka má verzi v Markdownu, například agents.md pro tuto stránku.