Skip to content

Commit 7ec38ea

Browse files
author
guide-factory[bot]
committed
Draft guide: atlassian (issue #135)
1 parent c3bccf6 commit 7ec38ea

6 files changed

Lines changed: 227 additions & 130 deletions

File tree

guides/atlassian/external.md

Lines changed: 18 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,34 +6,43 @@ setup_version: 1
66

77
You need an Atlassian Cloud site with Jira, Confluence, and/or Compass, and the connecting Atlassian account must have access to the intended site and apps. Use a modern browser. Atlassian documents no paid-plan requirement for the MCP Server.
88

9-
You need no Atlassian-side configuration unless your organization restricts OAuth client domains, IP addresses, third-party apps, or network egress. If it does, sign in to Atlassian Administration with an organization-admin account and complete the applicable checks below.
9+
You need no Atlassian-side configuration unless your organization restricts OAuth client domains, IP addresses, third-party apps, or network egress. For OAuth-domain or IP-allowlist restrictions, sign in to Atlassian Administration with an organization-admin account and complete the applicable checks below. If **User Installed Apps** is blocked, ask a site admin for help. For strict egress filtering, ask your network/security owner to allow the required Atlassian domain.
1010

1111
### Allow the Speakeasy OAuth domain {#allow-speakeasy-domain}
1212

1313
1. Open [admin.atlassian.com](https://admin.atlassian.com/).
1414
2. If more than one organization is shown, select the organization you want to connect.
1515
3. Select **Rovo**.
1616
4. Select **Rovo MCP server**.
17-
5. Obtain the exact OAuth redirect domain from your Speakeasy deployment owner.
18-
6. Check whether that domain is already covered by the allowed domains.
19-
7. If it is not covered, select **Add domain**.
20-
8. If it is not covered, add the trusted redirect domain with its protocol and valid host. Use HTTPS for the hosted client.
21-
9. If it is not covered, use the submission control shown in the console.
17+
5. Check whether the allowed domains cover this hosted OAuth callback:
18+
19+
```
20+
https://app.getgram.ai/mcp/remote_login_callback
21+
```
22+
23+
6. If it is not covered, select **Add domain**.
24+
7. Enter this exact custom domain pattern:
25+
26+
```
27+
https://app.getgram.ai/mcp/remote_login_callback
28+
```
29+
30+
8. Use the submission control shown in the console.
2231

2332
Keep **Allow Atlassian supported domains** selected. Deselecting it blocks Atlassian's supported-domain set.
2433

2534
If your organization uses IP allowlists:
2635

27-
1. Ask your Speakeasy deployment owner for the connection's source IP addresses or CIDR blocks.
28-
2. Return to your organization in [admin.atlassian.com](https://admin.atlassian.com/).
36+
1. Ask your network/security owner whether hosted Speakeasy traffic has stable outbound IP addresses or CIDR blocks that your organization can allow. Do not guess these ranges.
37+
2. If your network/security owner supplies ranges, return to your organization in [admin.atlassian.com](https://admin.atlassian.com/).
2938
3. Select **Security**.
3039
4. Select **IP allowlists**.
3140
5. Open the applicable allowlist, or select **Create IP allowlist**.
3241
6. Enter a name and the source IP addresses or CIDR blocks in the fields shown.
3342
7. Select the Atlassian sites and apps to which the allowlist applies.
3443
8. Use the submission control shown in the console.
3544

36-
If your organization uses strict egress filtering, allow the following domain so interactive Jira and Confluence widgets can render:
45+
If your organization uses strict egress filtering, ask your network/security owner to allow the following domain in your organization's network controls so interactive Jira and Confluence widgets can render:
3746

3847
```
3948
*.atlassian.net

guides/atlassian/meta.yaml

Lines changed: 28 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ credential_setup:
1616
- id: product-access
1717
description: Atlassian account with access to the intended Cloud site and products
1818
- id: organization-policy-approval
19-
description: Organization-admin approval when OAuth domains, IP allowlists, or User Installed Apps policy restrict the connection
19+
description: Administrative action when OAuth domains, IP allowlists, or User Installed Apps policy restrict the connection
2020
documentation:
2121
external: external.md
2222
speakeasy: speakeasy.md
@@ -31,91 +31,97 @@ remotes:
3131
locator: https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/
3232
name: Getting started with the Atlassian Rovo MCP Server
3333
classification: official
34-
observed_at: "2026-08-07T18:48:21Z"
34+
observed_at: "2026-08-07T19:24:55Z"
3535
- source: endpoint-observation
3636
locator: https://mcp.atlassian.com/v1/mcp/authv2
3737
classification: official
38-
observed_at: "2026-08-07T18:48:21Z"
38+
observed_at: "2026-08-07T19:24:55Z"
3939
- source: endpoint-observation
4040
locator: https://mcp.atlassian.com/.well-known/oauth-protected-resource/v1/mcp/authv2
4141
classification: official
42-
observed_at: "2026-08-07T18:48:21Z"
42+
observed_at: "2026-08-07T19:24:55Z"
4343
provenance:
4444
- source: pulsemcp
4545
locator: query:atlassian
46-
name: No exact Atlassian title/name match
46+
name: No exact current Atlassian Rovo title/name match
4747
classification: mirror
48-
status: ambiguous
49-
observed_at: "2026-08-07T18:48:21Z"
48+
status: ambiguous; deprecated old external-protocol entry excluded
49+
observed_at: "2026-08-07T19:24:55Z"
50+
- source: workflow-operator-notes
51+
locator: assignment:atlassian
52+
name: Speakeasy callback and catalog-path observations
53+
classification: official
54+
status: hosted callback confirmed; hosted outbound IP ranges unknown
55+
observed_at: "2026-08-07T19:24:55Z"
5056
- source: provider-documentation
5157
locator: https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/
5258
name: Getting started with the Atlassian Rovo MCP Server
5359
classification: official
54-
observed_at: "2026-08-07T18:48:21Z"
60+
observed_at: "2026-08-07T19:24:55Z"
5561
- source: provider-documentation
5662
locator: https://support.atlassian.com/atlassian-rovo-mcp-server/docs/setting-up-clients/
5763
name: Setting up clients
5864
classification: official
59-
observed_at: "2026-08-07T18:48:21Z"
65+
observed_at: "2026-08-07T19:24:55Z"
6066
- source: provider-documentation
6167
locator: https://support.atlassian.com/atlassian-rovo-mcp-server/docs/authentication-and-authorization/
6268
name: Authentication and authorization
6369
classification: official
64-
observed_at: "2026-08-07T18:48:21Z"
70+
observed_at: "2026-08-07T19:24:55Z"
6571
- source: provider-documentation
6672
locator: https://support.atlassian.com/atlassian-rovo-mcp-server/docs/configuring-oauth-2-1/
6773
name: Configuring OAuth 2.1
6874
classification: official
69-
observed_at: "2026-08-07T18:48:21Z"
75+
observed_at: "2026-08-07T19:24:55Z"
7076
- source: provider-documentation
7177
locator: https://support.atlassian.com/atlassian-rovo-mcp-server/docs/configuring-authentication-via-api-token/
7278
name: Configuring authentication via API token
7379
classification: official
74-
observed_at: "2026-08-07T18:48:21Z"
80+
observed_at: "2026-08-07T19:24:55Z"
7581
- source: provider-documentation
7682
locator: https://support.atlassian.com/atlassian-rovo-mcp-server/docs/using-with-other-supported-mcp-clients/
7783
name: Using with other supported MCP clients
7884
classification: official
79-
observed_at: "2026-08-07T18:48:21Z"
85+
observed_at: "2026-08-07T19:24:55Z"
8086
- source: provider-documentation
8187
locator: https://support.atlassian.com/security-and-access-policies/docs/control-atlassian-rovo-mcp-server-settings/
8288
name: Control Atlassian Rovo MCP server settings
8389
classification: official
84-
observed_at: "2026-08-07T18:48:21Z"
90+
observed_at: "2026-08-07T19:24:55Z"
8591
- source: provider-documentation
8692
locator: https://support.atlassian.com/security-and-access-policies/docs/specify-ip-addresses-for-product-access/
8793
name: Specify IP addresses for product access
8894
classification: official
89-
observed_at: "2026-08-07T18:48:21Z"
95+
observed_at: "2026-08-07T19:24:55Z"
9096
- source: provider-documentation
9197
locator: https://support.atlassian.com/security-and-access-policies/docs/available-atlassian-rovo-mcp-server-domains/
9298
name: Available Atlassian Rovo MCP server domains
9399
classification: official
94-
observed_at: "2026-08-07T18:48:21Z"
100+
observed_at: "2026-08-07T19:24:55Z"
95101
- source: provider-documentation
96102
locator: https://support.atlassian.com/atlassian-rovo-mcp-server/docs/troubleshooting-and-verifying-your-setup/
97103
name: Troubleshooting and verifying your setup
98104
classification: official
99-
observed_at: "2026-08-07T18:48:21Z"
105+
observed_at: "2026-08-07T19:24:55Z"
100106
- source: provider-marketing
101107
locator: https://www.atlassian.com/platform/remote-mcp-server
102108
name: Atlassian Rovo MCP server
103109
classification: official
104-
observed_at: "2026-08-07T18:48:21Z"
110+
observed_at: "2026-08-07T19:24:55Z"
105111
- source: endpoint-observation
106112
locator: https://mcp.atlassian.com/v1/mcp/authv2
107113
classification: official
108-
observed_at: "2026-08-07T18:48:21Z"
114+
observed_at: "2026-08-07T19:24:55Z"
109115
- source: endpoint-observation
110116
locator: https://mcp.atlassian.com/.well-known/oauth-protected-resource/v1/mcp/authv2
111117
classification: official
112-
observed_at: "2026-08-07T18:48:21Z"
118+
observed_at: "2026-08-07T19:24:55Z"
113119
- source: endpoint-observation
114120
locator: https://auth.atlassian.com/VCeDsk8ZHncYF1g234fKtc4lNipbBhu3/.well-known/oauth-authorization-server
115121
classification: official
116-
observed_at: "2026-08-07T18:48:21Z"
122+
observed_at: "2026-08-07T19:24:55Z"
117123
- source: repository-doctrine
118124
locator: doctrine/speakeasy-setup.md
119125
name: Speakeasy setup canonical section
120126
classification: official
121-
observed_at: "2026-08-07T18:48:21Z"
127+
observed_at: "2026-08-07T19:24:55Z"

0 commit comments

Comments
 (0)