Document Atlassian MCP Server integration with MCP Gateway

[crivetimihai]

Overview

Document how to integrate the official Atlassian MCP Server with MCP Gateway for software development workflows.

Server Details

• Provider: Atlassian
• Category: Software Development
• Endpoint: https://mcp.atlassian.com/v1/sse
• Authentication: OAuth2.1
• Protocol: Server-Sent Events (SSE)

Documentation Requirements

File Location

Create: docs/docs/using/servers/atlassian/atlassian-mcp.md

Content Structure

1. Overview

   • Introduction to Atlassian MCP Server
   • Available tools and capabilities
   • Integration benefits with Jira, Confluence, Bitbucket

2. Prerequisites

   • Atlassian account and workspace setup
   • OAuth2.1 application registration
   • Required permissions and scopes

3. Authentication Setup

   • OAuth2.1 flow configuration
   • Client ID and secret management
   • Token refresh handling
   • Scope configuration for Atlassian services

4. MCP Gateway Integration

   • Server registration in MCP Gateway
   • SSE endpoint configuration
   • Authentication middleware setup
   • Error handling and retry logic

5. Available Tools

   • Document available Atlassian tools
   • Jira issue management tools
   • Confluence page operations
   • Bitbucket repository tools
   • User and workspace management

6. Usage Examples

   • Creating and updating Jira issues
   • Managing Confluence pages
   • Repository operations
   • Workflow automation examples

7. Troubleshooting

   • Common OAuth setup issues
   • SSE connection problems
   • Rate limiting considerations
   • Permission and scope errors

Configuration Examples

# MCP Gateway server configuration
servers:
  - id: "atlassian-official"
    name: "Atlassian MCP Server"
    description: "Official Atlassian software development tools"
    transport:
      type: "sse"
      endpoint: "https://mcp.atlassian.com/v1/sse"
      auth:
        type: "oauth2"
        client_id: "${ATLASSIAN_CLIENT_ID}"
        client_secret: "${ATLASSIAN_CLIENT_SECRET}"
        scopes: ["read:jira", "write:jira", "read:confluence", "write:confluence"]
        token_endpoint: "https://auth.atlassian.com/oauth/token"
    settings:
      timeout: 60
      retry_attempts: 3

Navigation Updates

Create docs/docs/using/servers/atlassian/.pages with:

title: Atlassian
nav:
  - atlassian-mcp.md

Update main servers .pages to include Atlassian section.

References

• Atlassian MCP Server Documentation
• Atlassian OAuth2.1 Guide
• MCP Gateway SSE configuration guide

Acceptance Criteria

• Comprehensive documentation file created
• OAuth2.1 authentication setup documented
• SSE endpoint integration guide provided
• Available tools and capabilities documented
• Configuration examples tested and verified
• Troubleshooting section with common issues
• Navigation structure updated
• Cross-references to related documentation added

Priority

Medium - Part of 0.8.0 public server documentation initiative

Use Cases

• Software development project management
• Documentation and knowledge management
• Code repository automation
• Issue tracking and workflow automation
• Team collaboration and productivity