> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Atlassian

> Kết nối Atlassian Jira và Confluence với CloudThinker để theo dõi issue, quản lý kiến thức và dự án

Kết nối tổ chức Atlassian của bạn để cho phép các agent CloudThinker theo dõi Jira issue, tìm kiếm kiến thức Confluence và lấy ngữ cảnh ticket trong quá trình ứng phó sự cố và code review. CloudThinker kết nối qua **Rovo MCP server** của Atlassian sử dụng tính năng cho phép theo domain.

***

## Điều kiện tiên quyết

* Một tổ chức **Atlassian Cloud** trên bất kỳ gói nào (Free, Standard, Premium hoặc Enterprise).
* Vai trò **Organization Admin** để thêm domain CloudThinker trong Atlassian Administration.

<Info>
  Chỉ Organization Admin mới có thể thêm domain trong cài đặt Atlassian AI. Sau khi thêm, tất cả thành viên workspace có thể sử dụng tích hợp trong phạm vi quyền hiện có của họ.
</Info>

***

## Thiết lập

<Steps>
  <Step title="Mở Atlassian Administration">
    Vào [admin.atlassian.com](https://admin.atlassian.com) → **Apps → AI settings → Rovo MCP server**.
  </Step>

  <Step title="Thêm domain CloudThinker">
    Nhấp **Add domain** và nhập:

    ```
    https://app.cloudthinker.io/**
    ```

    Nhấp **Save**.

    <Frame>
      <img src="https://mintcdn.com/cloudthinker/GO078to2qMKOXjFU/images/atlassian-integration.png?fit=max&auto=format&n=GO078to2qMKOXjFU&q=85&s=ecd87846f4782ae0d0202c02f0cf65c0" alt="Cài đặt Atlassian AI hiển thị domain CloudThinker trong danh sách cho phép Rovo MCP server" width="3024" height="1716" data-path="images/atlassian-integration.png" />
    </Frame>

    <p style={{textAlign: 'center', fontSize: '0.9em', color: '#666', marginTop: '8px'}}>Cài đặt Atlassian AI — danh sách domain cho phép của Rovo MCP server</p>
  </Step>

  <Step title="Cấu hình IP allowlisting (nếu áp dụng)">
    Nếu tổ chức của bạn áp dụng IP allowlisting, hãy cấu hình danh sách cho phép trong **Atlassian Administration** (không phải trong cài đặt AI). Các yêu cầu phải xuất phát từ IP được cho phép ngay cả đối với các domain đáng tin cậy.

    Sau khi lưu, CloudThinker hiển thị trạng thái **Connected** cho tích hợp Atlassian.
  </Step>
</Steps>

***

## Chi tiết kết nối

| Trường              | Mô tả                                                                | Giá trị                                       |
| ------------------- | -------------------------------------------------------------------- | --------------------------------------------- |
| **Allowed domain**  | Domain CloudThinker được thêm vào danh sách cho phép Rovo MCP server | `https://app.cloudthinker.io/**`              |
| **Connection type** | Cơ chế xác thực                                                      | Danh sách domain cho phép của Rovo MCP server |

***

## Quyền hạn cần thiết

* Vai trò **Organization Admin** là bắt buộc để thêm domain trong quá trình thiết lập.
* Sau khi kết nối, các agent hoạt động với **quyền hiện có của người dùng ủy quyền** — CloudThinker không thể truy cập các project Jira hoặc space Confluence mà người dùng không thể xem.

<Tip>
  Tuân thủ nguyên tắc đặc quyền tối thiểu: ủy quyền kết nối từ tài khoản người dùng có quyền Atlassian khớp chính xác với những gì CloudThinker cần.
</Tip>

***

## Khả năng của agent

Sau khi kết nối, các agent có thể truy cập dữ liệu Jira và Confluence trong phạm vi quyền của người dùng ủy quyền.

| Khả năng                      | Mô tả                                                  |
| ----------------------------- | ------------------------------------------------------ |
| **Tìm kiếm Jira issue**       | Tìm và truy xuất issue trên các project và sprint      |
| **Quản lý Jira issue**        | Tạo, cập nhật và bình luận trên issue                  |
| **Tìm kiếm Confluence**       | Tìm kiếm và đọc trang và space                         |
| **Ngữ cảnh project & sprint** | Lấy ngữ cảnh ticket trong ứng phó sự cố và code review |

### Xác minh kết nối

```text theme={null}
@alex list open Jira issues from the PLATFORM project and summarize blockers
```

### Các lệnh mẫu

```text theme={null}
@alex find all open Jira issues blocking the current sprint and #report priority and assignee
@alex search Confluence for the incident response runbook
@oliver find all open Jira security issues and summarize the critical ones
```

***

## Xử lý sự cố

<Accordion title="Domain không có trong danh sách cho phép">
  CloudThinker không thể kết nối vì domain chưa được lưu. Quay lại admin.atlassian.com → Apps → AI settings → Rovo MCP server và xác nhận `https://app.cloudthinker.io/**` xuất hiện trong danh sách.
</Accordion>

<Accordion title="IP allowlisting chặn yêu cầu">
  Người dùng trên các IP bị chặn thấy lỗi quyền ngay cả khi domain đã được cho phép. Thêm các IP CloudThinker trong Atlassian Administration (không phải trong cài đặt AI) và đảm bảo các yêu cầu xuất phát từ địa chỉ được cho phép.
</Accordion>

<Accordion title="Quyền truy cập bị từ chối trên project Jira hoặc space Confluence">
  CloudThinker hoạt động với quyền của người dùng ủy quyền. Đảm bảo người dùng ủy quyền có quyền truy cập vào các project Jira và space Confluence mà bạn muốn agent tiếp cận.
</Accordion>

<Accordion title="Kết nối không xuất hiện trong CloudThinker">
  Thay đổi danh sách domain cho phép có thể mất vài phút để áp dụng. Chờ một lúc, sau đó làm mới trang Connections của CloudThinker.
</Accordion>

***

## Bảo mật

* **Quyền tối thiểu** — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
* **Chỉ đọc theo mặc định** — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
* **Xoay vòng thông tin xác thực** — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
* **Thu hồi khi bàn giao** — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.

- **Chỉ Organization Admin** — chỉ Organization Admin mới có thể thêm hoặc xóa domain CloudThinker; thường xuyên kiểm tra danh sách quyền này.
- **Truy cập bị giới hạn bởi người dùng** — các hành động CloudThinker bị giới hạn bởi quyền Atlassian của người dùng ủy quyền; luôn ủy quyền từ tài khoản có đặc quyền tối thiểu.

***

## Liên quan

<CardGroup cols={2}>
  <Card title="Kết nối GitGuardian" icon="https://mintcdn.com/cloudthinker/tTYzPaZv-jtM39C4/images/icons/gitguardian.svg?fit=max&auto=format&n=tTYzPaZv-jtM39C4&q=85&s=b89a979a6dd2d28506ae7517286d83e4" href="/vi/guide/connections/gitguardian" width="24" height="24" data-path="images/icons/gitguardian.svg">
    Theo dõi sự cố secret dưới dạng Jira issue
  </Card>

  <Card title="Kết nối ServiceNow" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/servicenow.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=3fee0d3d5346b20beb018bcf854e968e" href="/vi/guide/connections/servicenow" width="24" height="24" data-path="images/icons/servicenow.svg">
    Quản lý sự cố ITSM
  </Card>
</CardGroup>