Connecting Atlassian — Jira & Confluence (setup checklist)

This checklist walks you through connecting Atlassian (Jira & Confluence) to Harriet.

You'll need: an Atlassian account with access to your organization's site, and access to Harriet's Company settings → Integrations.

How access works (before you start)

Setup registers an OAuth app — Harriet does not act with the admin's Atlassian account. Each user connects their own Atlassian account under Profile → Integrations, and Harriet can only see and change what that user's Jira/Confluence permissions allow.

Step 1 — Create an OAuth 2.0 integration

1. Go to developer.atlassian.com/console/myapps.
2. Click Create → OAuth 2.0 integration.
3. Name it (e.g. Harriet) and save.

Step 2 — Add the redirect URLs

1. Open Authorization in the left menu.
2. Add both URLs (one per line):

https://hrharriet.com/bots/integrations/mcp/oauth/callback/
https://harriethq.com/bots/integrations/mcp/oauth/callback/

1. Click Save changes.

Step 3 — Add the permissions

Open Permissions in the left menu and click Configure on each API:

API	Scopes to enable
Jira API	read:jira-work, write:jira-work, read:jira-user
Confluence API	read:confluence-content.all, read:confluence-space.summary, read:confluence-user
User Identity API	read:me

Step 4 — Enable sharing (required for colleagues)

New Atlassian apps are private by default — only the owner can authorize them. Anyone else gets "You don't have access to this app. This application is in development - only the owner of this application may grant it access to their account."

1. Open Distribution in the left menu.
2. In the Enable sharing section, turn the toggle on.
3. Fill in the short vendor form and save. Atlassian asks for a vendor name, contact email, and a privacy policy link plus a data-residency declaration — this is required even for internal-only sharing; your company website's privacy page is fine for the link.

Step 5 — Copy the credentials

Open Settings in the left menu and copy the Client ID and Secret.

Step 6 — Configure in Harriet and finish

1. In Harriet, open the Atlassian connector and paste the Client ID and Secret, then save.
2. Connect your own account: click Connect, sign in with Atlassian, select your site (e.g. yourcompany.atlassian.net), and click Accept.
3. Back in the connector settings, scroll to Tool permissions, click Sync tools, enable the tools you want, and save.
4. Attach the connector to a skill and assign the skill.
5. Verify: ask Harriet something like "show my open Jira issues."

Troubleshooting

Symptom	Most likely cause
"You don't have access to this app … only the owner … may grant it access"	Sharing isn't enabled — turn on Distribution → Enable sharing (Step 4).
OAuth error during sign-in	Redirect URL missing or inexact (Step 2), or Client ID/secret mismatch (Step 5).
Jira works but Confluence doesn't (or vice versa)	That API's scopes weren't configured under Permissions (Step 3).
Wrong or missing site data	The user selected the wrong Atlassian site during connect — disconnect and reconnect under Profile → Integrations.
Setup complete but users see nothing	Tools not synced/enabled, or connector not attached to an assigned skill (Step 6).

See also How to create an MCP connector (Company settings).