Atlassian

Connect Pencel to your Atlassian suite — Jira, Confluence, and Bitbucket — through a single integration. Your agents can read and update issues, search knowledge base articles, and interact with your development workflow without switching between tools.

Trust Level	Partner
Transport	Remote (OAuth)
Endpoint	https://mcp.atlassian.com/v1/sse
Activation	When relevant recommended

What Your Agent Can Do

The Atlassian integration gives your agents access to tools across three products:

Jira

• Search for issues using JQL (Jira Query Language).
• Read issue details, comments, and status history.
• Create new issues with type, priority, and assignee.
• Update issue status, add comments, and transition workflows.
• List projects and boards.

Confluence

• Search pages and spaces.
• Read page contents.
• Create new pages.
• Update existing page content.

Bitbucket

• List repositories and branches.
• Read file contents and pull requests.
• Search code across repositories.

Setup

Atlassian uses remote OAuth — you sign in with your Atlassian account directly. No API tokens to manage.

Step 1: Add the Connection

1. Open Settings > Connections.
2. Click Add Connection and select Atlassian from the catalog.
3. Click Connect.

Step 2: Authorize with Atlassian

1. Pencel opens your browser to the Atlassian sign-in page.
2. Sign in with your Atlassian account.
3. Select the Atlassian site (e.g., yourcompany.atlassian.net) you want to connect.
4. Review the permissions and click Allow.
5. Return to Pencel. Your connection card shows the available tools.

INFO

You can connect multiple Atlassian sites by adding separate connections. Each connection authorizes against one site.

Step 3: Verify Access

After connecting, check that your agent can access the projects and spaces you need. The integration uses your account's permissions — if you cannot see a project in Jira, neither can your agent.

WARNING

Your agent acts with your Atlassian permissions. Any changes it makes (creating issues, updating pages) appear as actions by your account. Make sure you are comfortable with the access level before running write operations.

Example: Weekly Status Report from Jira

Imagine you need a weekly summary of your team's Jira activity.

Workflow setup:

1. Create a workflow called "Weekly Jira Status Report."
2. Add a step with these instructions:

Search Jira for all issues in the ACME project that were updated in the last 7 days. Group them by status: Done, In Progress, and Blocked. For each blocked issue, include the latest comment explaining the blocker. Format the results as a status report with counts per status and a detailed section for blocked items. Save to the workspace as /reports/jira-weekly-[date].md.

3. Schedule the workflow to run every Friday at 4:00 PM.

Your team gets a clear end-of-week snapshot without anyone manually pulling data from Jira.

Example: Sync Confluence Decisions to Workspace

Search Confluence for pages in the "Architecture Decisions" space that were created or modified in the last 30 days. For each page, extract the decision title, date, status, and summary. Create a consolidated markdown file in the workspace at /decisions/recent.md.

This keeps important decisions accessible in your local workspace without needing to browse Confluence.

Example: Sprint Retrospective

Pull all issues from the ACME project that were completed in the current sprint. Categorize them by type (bug, feature, improvement). Calculate the total story points completed. Check for any issues that were moved back to "To Do" during the sprint. Write a retrospective summary highlighting what was shipped, what slipped, and any patterns in blocked items.

Troubleshooting

Problem	Solution
OAuth window does not open	Check that your default browser is configured. Pencel opens the system browser for Atlassian sign-in.
Cannot see certain projects	Your agent uses your Atlassian permissions. If a project is restricted, you need access in Atlassian first.
"Site not found" error	Make sure you selected the correct Atlassian site during the OAuth step. You may have multiple sites.
Connection drops after a few hours	OAuth tokens expire. Disconnect and reconnect to refresh the token.
JQL queries return empty results	Double-check your JQL syntax. Project keys are case-sensitive (e.g., ACME not acme).