Atlassian Cloud

Step-by-Step Instructions for Obtaining Atlassian ENV Values

For Atlassian Cloud (API Token Authentication – Recommended)

To connect to Confluence or Jira Cloud using an API token:

1. Log in to Atlassian Account

   • Go to Atlassian Account Security.

2. Create API Token

   • Click on Create API token.
   • Enter a label/name for your token to remember its purpose.
   • Click Create.

3. Copy the Token

   • Copy the newly generated token immediately and keep it secure; you will not be able to view it again.

4. Determine Your Username

   • Your username is usually your Atlassian email address.

5. Get your Atlassian URLs

   • Confluence Cloud URL: Will look like https://your-company.atlassian.net/wiki
   • Jira Cloud URL: Will look like https://your-company.atlassian.net

6. Enter the Values in FastMCP

   • In the FastMCP connection interface (click your "Install Now" button), fill in the following fields:
     • For Jira:
       • JIRA_URL: The full Jira instance URL.
       • JIRA_USERNAME: Your Atlassian email address.
       • JIRA_API_TOKEN: The API token you just created.
     • For Confluence:
       • CONFLUENCE_URL: The full Confluence instance URL.
       • CONFLUENCE_USERNAME: Your Atlassian email address.
       • CONFLUENCE_API_TOKEN: The API token you just created.

For Atlassian Server/Data Center (Personal Access Token)

To connect to Confluence or Jira Server/Data Center using a Personal Access Token:

1. Log in to the appropriate Atlassian product (Confluence or Jira)

   • Go to the web interface for your organization's Jira or Confluence server.

2. Navigate to Personal Access Tokens

   • Click your user profile (avatar), then Profile.
   • Find Personal Access Tokens in the menu (location may vary depending on version).

3. Create a Personal Access Token

   • Click Create token.
   • Provide a name/label and set an expiry if prompted.
   • Click Create.

4. Copy the Token

   • Copy the Personal Access Token immediately and store it securely.

5. Get Your Server URLs

   • Confluence Server URL: Looks like https://confluence.your-company.com
   • Jira Server URL: Looks like https://jira.your-company.com

6. Enter the Values in FastMCP

   • In the FastMCP connection interface (click your "Install Now" button), fill in the following fields:
     • For Jira:
       • JIRA_URL: The full Jira instance URL.
       • JIRA_PERSONAL_TOKEN: The Personal Access Token you created.
     • For Confluence:
       • CONFLUENCE_URL: The full Confluence instance URL.
       • CONFLUENCE_PERSONAL_TOKEN: The Personal Access Token you created.

For OAuth 2.0 (Advanced Usage)

If you are setting up OAuth 2.0, follow these steps (usually for advanced or organizational setups):

1. Go to Atlassian Developer Console.
2. Create an OAuth 2.0 (3LO) integration app.
3. Set the required permissions (scopes) for Jira/Confluence.
4. Set a Callback URL (for example: http://localhost:8080/callback).
5. Run the --oauth-setup wizard in your setup environment (see README for specifics).
6. Complete the prompts and OAuth flow in your browser.
7. Copy the following values from the wizard and Developer Console:
   • ATLASSIAN_OAUTH_CLIENT_ID
   • ATLASSIAN_OAUTH_CLIENT_SECRET
   • ATLASSIAN_OAUTH_REDIRECT_URI
   • ATLASSIAN_OAUTH_SCOPE (should include offline_access)
   • ATLASSIAN_OAUTH_CLOUD_ID (from setup wizard)
8. Enter all these values in the FastMCP connection interface.

Note:

• For custom header support and proxy configuration, see advanced sections in the README.
• Make sure your tokens and .env files are kept secure and never shared or exposed publicly.

You may now use the "Install Now" button and fill in your values in the FastMCP connection interface as described above.