Ga naar inhoud

Jira en Confluence (Atlassian)

Artific Connect · Atlassian geeft een sleutel tools voor Jira en Confluence Cloud: issues zoeken en wijzigen, pagina's zoeken en wijzigen, over je eigen Atlassian-site. Je installeert hem vanaf de Marktplaats, net als elke andere bundel.

Wat je krijgt

Eén toolset, atlassian, met acht koppelingen — vijf over Jira, drie over Confluence — plus een skill die het model vertelt hoe een JQL- of CQL-query eruitziet en wat een transition-id is. Elke aanroep loopt via het eigen Atlassian-account van je organisatie, niet via het eigen inloggen van een persoon: anders dan bij GitHub of Linear logt hier niemand individueel in.

Je eigen site en API-token

Deze bundel vraagt bij het installeren om twee dingen, allebei van je eigen organisatie:

  • atlassian_site — je Atlassian-site, vooraf ingevuld met een standaardwaarde die je bewerkt door your-site te vervangen door de subdomeinnaam van je eigen site (het deel voor .atlassian.net) en de rest precies zo te laten staan: https://your-site.atlassian.net. Elk van de acht koppelingen hieronder voegt zijn eigen pad toe aan dit ene adres — de vijf Jira-koppelingen onder /rest/api/3/..., de drie Confluence-koppelingen onder /wiki/... op dezelfde site — dus eenmaal invullen is genoeg voor de hele bundel.

  • atlassian_credential — je Atlassian-accountmail en een API-token, aangemaakt op id.atlassian.com onder Security → API tokens. Geef hem op als:

{ "type": "basic", "username": "<accountmail>", "password": "<API-token>" }

Zolang beide niet zijn opgegeven staat het abonnement op wacht op configuratie. Elke waarde is van jou; deze omgeving registreert namens jou niets bij Atlassian.

Voordat het werkt

Je beheerder moet *.atlassian.net toestaan in het uitgaand verkeer van de sleutel — alleen je eigen site, onder die glob, wordt ooit bereikt, want atlassian_site is het enige adres waar deze bundel ooit een aanroep vanaf begint.

De acht tools

Tool Vraag hem om Geef hem
api__jira-search Jira-issues die overeenkomen een JQL-query
api__jira-get-issue de details van één issue zijn key, bijv. ENG-123
api__jira-create-issue een nieuwe issue een projectkey, een issue-type en een samenvatting
api__jira-add-comment een reactie toevoegen de key van de issue en de reactietekst
api__jira-transition een issue verplaatsen de key van de issue en een transition-id (eerst uit de issue gelezen)
api__confluence-search Confluence-pagina's die overeenkomen een CQL-query
api__confluence-get-page de inhoud van één pagina haar id
api__confluence-create-page een nieuwe pagina een space-id, een titel en de inhoud

Goed om te weten

  • Geverifieerd op 2026-09-24 op developer.atlassian.com: /rest/api/3/... (Basic auth met een API-token) is Jira Cloud's eigen REST v3, en HTTP Basic met een accountmail en API-token is de gedocumenteerde authenticatie ervoor voor scripts. Het lezen en schrijven van Confluence-pagina's gebeurt op de v2-API (/wiki/api/v2/pages); CQL-zoeken staat nog op de oudere v1-API (/wiki/rest/api/search) — Atlassian heeft dat nog niet naar v2 verplaatst, dus deze bundel mengt de twee bewust.
  • Geverifieerd op 2026-09-24: het oude GET /rest/api/3/search-eindpunt dat Atlassian ooit voor JQL documenteerde is uitgefaseerd (410 Gone sinds augustus 2025); deze bundel gebruikt in plaats daarvan het huidige POST /rest/api/3/search/jql.
  • Besloten op 2026-09-24: deze bundel gebruikt REST met een API-token in plaats van Atlassians eigen gehoste MCP-server (mcp.atlassian.com), omdat niet vaststond of een applicatie van een derde partij zoals Artific daar een OAuth-client bij mag registreren; REST met een API-token is vandaag beschikbaar voor elke Atlassian Cloud-site, zonder enige registratie bij Atlassian.
  • Elk Jira-project of Confluence-space past nog zijn eigen rechten toe boven op wat het account van het token kan zien; "niet gevonden" bij een issue of pagina betekent meestal dat het account het niet kan zien.
  • Het beeldmerk: de kaart van deze bundel gebruikt Atlassians eigen beeldmerk, van diens logo-download, onder de Marketplace Partner-richtlijnen, die een partner toestaan Atlassians logo in eigen marketingmateriaal te gebruiken (gecontroleerd op 2026-09-24).