IT

Connecting Atlassian — Jira & Confluence (setup checklist)

Step-by-step checklist for connecting the Atlassian connector — OAuth 2.0 integration, redirect URLs, and the Jira/Confluence scopes to enable.

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 — Copy the credentials

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

Step 5 — 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
OAuth error during sign-in Redirect URL missing or inexact (Step 2), or Client ID/secret mismatch (Step 4).
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 5).

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

Use Harriet in your organisation for searchable help, AI assistance, and your company knowledge base.

Log in to Harriet