Syntra koppelen aan Claude en ChatGPT
Met de Syntra-connector werken Claude en ChatGPT met uw Syntra-werkruimte via het open Model Context Protocol (MCP). Stel in gewone taal vragen over projecten, taken, risico’s en sprints en laat de assistent ze, waar uw werkruimte dat toestaat, voor u aanmaken en bijwerken.
Vereisten
- Een Syntra-account dat lid is van een werkruimte met een betaald abonnement: Starter, Business of Enterprise. Lezen via Claude en ChatGPT zit in elk betaald abonnement; schrijven hoort bij het Enterprise-abonnement, samen met de API en webhooks. Zie prijzen.
- Claude (elk abonnement dat connectors ondersteunt) of ChatGPT (een abonnement waarin u een eigen MCP-server kunt toevoegen).
- Niets te installeren, geen OAuth-app te registreren, geen client-ID of API-sleutel aan te maken. U logt in uw browser in bij Syntra, kiest de werkruimte en staat de toegang één keer toe.
Serveradres: https://syntra.tymko.tech/mcp. De werkruimte kiest u op de toestemmingspagina tijdens het koppelen. Bent u lid van meerdere werkruimten en wilt u per werkruimte een aparte connector, dan kunt u in plaats daarvan het eigen adres van een werkruimte gebruiken, https://syntra.tymko.tech/mcp/<workspace>, dat Syntra toont op de API-pagina van de werkruimte. Dit is optioneel.
Koppelen in Claude
Syntra staat als communityconnector in de connectorcatalogus van Claude (Claude Connectors Directory). Claude identificeert zich automatisch bij Syntra met een Client ID Metadata Document, dus u hoeft geen OAuth-app, client-ID of API-sleutel in te stellen. De connector werkt in Claude op het web, in Claude Desktop en in de mobiele apps.
- Zoek Syntra.Open in Claude Customize (of Settings) → Connectors, zoek op Syntra en klik op Connect. U kunt ook direct de Syntra-vermelding openen.
- Log in bij Syntra.Er opent een Syntra-venster; log in met uw Syntra-account (en uw tweede factor, als die aan staat).
- Kies de werkruimte en sta toegang toe.De toestemmingspagina toont de app (Claude, claude.ai), uw gebruiker, het toegangsniveau en waarheen u wordt teruggestuurd. Bent u lid van meerdere werkruimten, kies er dan één en klik op “Toestaan”.
- Stel uw vraag.Vraag in een nieuwe chat naar uw projecten. Claude roept de Syntra-tools aan en toont elke aanroep die het doet.
Claude Code koppelt op dezelfde manier: claude mcp add --transport http syntra https://syntra.tymko.tech/mcp, voer daarna /mcp uit om in te loggen.
Koppelen in ChatGPT
- Voeg een eigen MCP-server toe.Open in ChatGPT Plugins (Settings → Apps), klik op Add en daarna op Add custom MCP server. Vul de URL
https://syntra.tymko.tech/mcpin en kies OAuth als authenticatie. - Log in en sta toe.ChatGPT identificeert zich automatisch, dus in Syntra hoeft u niets te registreren. Log in bij Syntra, kies de werkruimte en klik op “Toestaan” op dezelfde toestemmingspagina als bij Claude; daar staat de app als ChatGPT (chatgpt.com).
- Gebruik het in een chat.Noem Syntra of kies het in het toolsmenu en stel dan uw vraag.
Syntra staat nog niet in de appcatalogus van ChatGPT en wordt daarom voorlopig toegevoegd als eigen MCP-server.
Andere MCP-clients
Andere clients die externe MCP-servers ondersteunen, koppelen met https://syntra.tymko.tech/mcp via OAuth met een OAuth-app die is geregistreerd in de werkruimte-instellingen op het tabblad “API”: dezelfde inlog- en toestemmingspagina als hierboven. Clients die hun eigen headers meesturen, kunnen in plaats daarvan een Syntra-toegangssleutel gebruiken, als Authorization: Bearer syn_…. Bijvoorbeeld Claude Code met een sleutel: claude mcp add --transport http syntra https://syntra.tymko.tech/mcp --header "Authorization: Bearer syn_…". Eigenaren en beheerders van de werkruimte geven sleutels uit in de werkruimte-instellingen op het tabblad “API”; elk lid kan een persoonlijke sleutel aanmaken onder “Instellingen” → “API-sleutels”. OAuth-apps en toegangssleutels horen bij het Enterprise-abonnement.
Tools
Elke verbinding krijgt de leestools. De schrijftools verschijnen alleen in het Enterprise-abonnement, als schrijven voor de werkruimte is ingeschakeld en u op de toestemmingspagina “lezen en schrijven” hebt toegestaan. Geen enkele tool kan iets verwijderen.
| Tool | Wat het doet |
|---|---|
list_projects | Projecten die u kunt zien: code, naam, status, voortgang, prioriteit, kwartaal, leider, deadline, afdeling, stoplichten, open risico’s. Alleen lezen. |
get_project | Eén project volledig: beschrijving, budget, stoplichten, taken per status, de taken zelf en de risico’s met hun mitigatie. Alleen lezen. |
list_tasks | Taken in al uw projecten of in één project, laatste wijzigingen eerst, te filteren op project, status, verantwoordelijke, sprint of wijzigingsdatum. Alleen lezen. |
list_sprints | Sprints per afdeling met data, status, aantallen taken en Story Points. Alleen lezen. |
get_sprint | Eén sprint volledig: doel, Story Points, de taken en de burndown. Alleen lezen. |
whoami | Als welke gebruiker en in welke werkruimte de verbinding werkt, en met welke rol. Alleen lezen. |
create_task | Maakt een taak of een bugmelding aan in een project, op uw naam. Schrijven. |
update_task | Wijzigt een taak: titel, beschrijving, status, verantwoordelijke, deadline, labels, Story Points, sprint. Schrijven. |
add_task_comment | Voegt een opmerking toe aan een taak; de verantwoordelijke en de projectleider krijgen een melding. Schrijven. |
create_project | Maakt een project aan met beschrijving, status, prioriteit, kwartaal, deadline en leider. Schrijven. |
update_project | Wijzigt de velden, stoplichten of het budget van een project. Schrijven. |
add_risk | Registreert een risico bij een project met ernst en mitigatie. Schrijven. |
update_risk | Wijzigt de tekst, ernst, mitigatie of status van een risico (sluiten of heropenen). Schrijven. |
create_sprint | Plant een nieuwe sprint voor een afdeling. Schrijven. |
update_sprint | Wijzigt de naam, het doel of de data van een geplande of actieve sprint. Schrijven. |
Voorbeeldvragen
- “Welke projecten lopen dit kwartaal achter op schema, en waarom?”
- “Wat is er sinds maandag veranderd in de marketingprojecten?”
- “Hoe loopt de huidige sprint? Toon de burndown en wat er nog openstaat.”
- “Wie heeft op dit moment de meeste achterstallige taken?”
- “Maak een bug aan in project P-117: de afrekenknop doet niets op iOS, met stappen om het te reproduceren.”
- “Voeg een hoog risico toe aan P-131: de leverancier haalt de lanceringsdatum mogelijk niet; mitigatie: een tweede leverancier.”
Rechten
- Uw rechten, niets meer. De assistent handelt als u binnen de gekozen werkruimte en ziet precies wat uw rol toestaat; beperkte projecten blijven verborgen als u ze niet kunt openen.
- Lezen voor elk lid. Leden van werkruimten met een betaald abonnement (Starter, Business of Enterprise) kunnen koppelen en lezen.
- Schrijven in Enterprise, als beide het toestaan. De schrijftools werken alleen in het Enterprise-abonnement, waar een Syntra-superadmin schrijven via MCP voor de werkruimte heeft ingeschakeld (de eigenaar vraagt dat aan bij support) en u op de toestemmingspagina “lezen en schrijven” hebt gekozen. Anders is de verbinding alleen-lezen, wat de assistent ook vraagt.
- Geen verwijderingen. Geen enkele tool verwijdert projecten, taken, risico’s, sprints of opmerkingen.
- Alleen de connector. Tokens die aan Claude en ChatGPT worden uitgegeven, werken alleen voor de MCP-verbinding, niet voor de rest van de Syntra-API.
- Zichtbare wijzigingen. Wijzigingen via de connector verschijnen in Syntra onder uw naam, in de geschiedenis van de taak en het project en in het auditlogboek.
Privacy en gegevens
Syntra stuurt de assistent alleen de resultaten van de tools die hij aanroept, beperkt tot wat u kunt zien. Syntra ontvangt en bewaart uw gesprekken met Claude of ChatGPT niet; wat de assistent met de resultaten van tools doet, valt onder de voorwaarden van Anthropic of OpenAI voor uw account. Inloggen gebeurt via OAuth 2.0 met PKCE: de assistent ziet uw Syntra-wachtwoord nooit, en Syntra bewaart alleen hashes van de tokens die het uitgeeft. Details staan in het privacybeleid, de lijst van subverwerkers en de verwerkersovereenkomst (DPA).
Ontkoppelen
Verwijder de connector in Claude of ChatGPT en trek de toestemming in Syntra in onder “Instellingen” → “API-sleutels” → “Mijn toestemmingen”. Elk lid doet dit voor de eigen toegang. Daarna werkt het refresh-token van de assistent direct niet meer, en het huidige toegangstoken verloopt binnen 24 uur. Een eigenaar van de werkruimte kan support ook vragen schrijven voor de hele werkruimte uit te schakelen.
Problemen oplossen
“Er is geen werkruimte waaraan u deze app kunt koppelen”
Geen van uw werkruimten heeft een betaald abonnement, of het werkruimteadres in de connector-URL hoort bij een werkruimte waarvan u geen lid bent. Vraag het de eigenaar van de werkruimte, of koppel met het algemene adres https://syntra.tymko.tech/mcp.
De assistent zegt dat de verbinding alleen-lezen is
De werkruimte heeft geen Enterprise-abonnement, schrijven staat er uit, of u hebt alleen lezen toegestaan. Voor schrijven is het Enterprise-abonnement nodig; vraag de eigenaar om schrijven te laten inschakelen, ontkoppel daarna, koppel opnieuw en kies “lezen en schrijven” op de toestemmingspagina.
Een project ontbreekt in de antwoorden
Vraag de assistent whoami uit te voeren: dat toont de gebruiker, werkruimte en rol die de verbinding gebruikt. Projecten die u in Syntra niet kunt openen, zijn ook voor de assistent niet zichtbaar.
Support
Schrijf naar support@tymko.tech met het tijdstip van het probleem en, indien mogelijk, de naam van de tool die de assistent toonde.