# Notion, Linear와 다른 앱

> AI가 쓸 수 있게 Notion, Linear, Atlassian, Figma, GitHub 같은 앱을 나만 쓰거나 팀이 같이 쓰도록 연결하는 방법과, 앱마다 필요한 주소나 키를 받는 곳을 정리했어요.

AI가 Trina AX 밖의 앱도 나 대신 쓸 수 있어요. Notion 페이지를 찾고, Linear 이슈를 열고, Jira 티켓을 읽어요. 앱마다 한
번만 연결하면 돼요. 대부분은 복사할 게 없어요. 그 앱 페이지에서 로그인하면 끝이에요. GitHub처럼 대신 키를 주는 앱도
몇 개 있어요.

> **참고:** 0.4.0 이전에는 이 화면 이름이 **외부 서비스**예요. 이 연결은 MCP를 써요. 앱이 AI에게 도구를 내주는 흔한 방식이에요. 쓰는
> 데 더 알아야 할 건 없어요.

## 내 앱은 어떻게 연결하나요

| 앱 | 필요한 것 | 안내 |
|---|---|---|
| Notion, Linear, Atlassian (Jira, Confluence), Figma, Canva, Stripe, Supabase, Cloudflare, Higgsfield와 **둘러보기**에 있는 다른 앱 | 그 앱의 내 계정. 복사할 건 없어요 | [둘러보기에서 앱에 로그인하기](#둘러보기에서-앱에-로그인하기) |
| GitHub | 개인 액세스 토큰 | [GitHub](#github) |
| "MCP server" 주소를 공개하는 다른 앱 | 그 주소, 앱이 요구하면 키도 | [주소로 앱 추가하기](#주소로-앱-추가하기) |
| 회사가 운영하는 시스템(API) | 주소, 키, 메모 | [회사 API](/docs/ko/use/api-connections.md) |
| Google Drive, Gmail, Calendar, Docs, Sheets | 내 Google 계정 | [Google 앱](/docs/ko/use/google-apps.md) |
| Slack | 멤버는 필요 없어요. 관리자가 한 번 추가해요 | [Slack](/docs/ko/use/slack.md) |

## 나만 쓰기, 팀이 같이 쓰기

| | 나만 | 팀 |
|---|---|---|
| 만드는 곳 | **설정 › 커넥터** | **관리자 › 연결한 서비스** (팀장과 관리자) |
| AI가 쓰는 계정 | 내 계정 | 로그인한 계정, 또는 저장한 키 |
| 쓰는 사람 | 나만, 내 채팅에서 | 관리자가 고른 팀 전체, 부서, 사람 |
| 볼 수 있는 사람 | 나만. 관리자도 못 봐요 | 관리자 |

팀 연결은 **한 번, 한 계정으로** 로그인해요. 그 연결을 쓰는 사람은 모두 그 앱에서 그 계정으로 일해요. 각자 자기
이름으로 일해야 한다면(내 Notion 페이지, 내 GitHub 권한) [템플릿](#템플릿-멤버가-각자-자기-키-쓰기)을 만들거나 각자 직접
연결하게 하면 돼요.

## 둘러보기에서 앱에 로그인하기

> **팁:** **필요한 것**
>
> - 브라우저에 로그인된 그 앱(Notion, Linear 등)의 계정.
> - 복사하거나 붙여 넣을 건 없어요. Trina AX가 그 앱의 공식 주소를 채워 줘요.

1. **커넥터 열기**

   왼쪽 막대 맨 아래의 내 사진을 누르고 **설정 › 커넥터**로 가요(폰에서는 **나** 탭). **둘러보기**에 연결할 수 있는
   앱이 나와요. **전체 보기**를 누르면 모두 보이고, **서비스 검색**으로 이름을 찾을 수 있어요.

   ![커넥터: 아직 연결한 게 없고, 같은 페이지 아래에 둘러보기가 있어요](../../images/mcp/connected.webp "설정 › 커넥터")

2. **앱을 열고 연결 누르기**

   앱 페이지에 AI가 거기서 할 수 있는 일과 도구 목록이 나와요. **연결**(또는 목록의 **+**)을 눌러요. 멤버에게는 팀 전체가
   쓰게 해 달라고 요청하는 **관리자에게 추가 요청하기**도 보여요.

   ![설정 › 커넥터의 Notion 페이지: 연결, 팀 전체가 쓰게 하고 싶나요? 관리자에게 추가 요청하기, AI가 하는 일, 도구 목록](../../images/connect/notion-page.webp "Notion 페이지")

3. **저장하고 로그인하기**

   창에 앱의 공식 주소가 나와요. **고급**은 그대로 두고 **저장하고 로그인**을 눌러요.

   ![Notion 추가 창: 채워진 주소, 접힌 고급(Advanced), 저장하고 로그인(Save and sign in)](../../images/mcp/add.webp "Notion 추가")

4. **앱 페이지에서 접근 허용하기**

   새 창에 그 앱(Notion, Linear 등)의 페이지가 열려요. 로그인하라고 하면 로그인하고, 워크스페이스를 고른 뒤 **허용**을
   눌러요(버튼 이름이 **계속**이나 **수락**일 수도 있어요). 창이 닫히고 Trina AX에 **로그인했어요.** 안내가 떠요. 앱이
   **내 커넥터**로 올라가고 **연결됨**이 보여요.

팀용은 관리자가 **관리자 › 연결한 서비스**에서 똑같이 해요. 앱을 열고 **팀용으로 연결**을 눌러요. 옆의 화살표를 누르면
**템플릿: 멤버가 각자 연결**도 고를 수 있어요. 그다음 쓸 사람을 골라요.

![관리자 › 연결한 서비스의 Notion 페이지: 다른 선택지를 여는 화살표가 붙은 팀용으로 연결, 그리고 Notion을 팀 공유 키 하나로 연결하거나 멤버가 각자 연결하는 템플릿으로 만들 수 있다는 안내](../../images/connect/admin-notion.webp "팀용 Notion")

로그인은 컴퓨터의 브라우저나 데스크톱 앱에서 해야 해요. 한번 연결하면 폰에서도 써요.

## GitHub

GitHub는 다른 앱이 알아서 로그인하게 해 주지 않아서 개인 액세스 토큰으로 연결해요. 주소로 앱을 추가하는 건 팀장과
관리자만 할 수 있어요. 멤버는 관리자에게 부탁하고, 관리자는 각자 자기 토큰을 쓰도록
[템플릿](#템플릿-멤버가-각자-자기-키-쓰기)을 만들 수 있어요.

> **팁:** **필요한 것**
>
> - **주소**: `https://api.githubcopilot.com/mcp/` (GitHub의 MCP 서버).
> - **키**: `github_pat_`로 시작하는 GitHub 개인 액세스 토큰.

1. **GitHub에서 토큰 만들기**

   [GitHub › Settings › Developer settings › Personal access tokens › Fine-grained tokens](https://github.com/settings/personal-access-tokens/new)를
   열고 **Generate new token**을 눌러요. 이름("Trina AX"), 만료일, 열 수 있는 저장소(**Only select repositories**가 가장
   안전해요), AI에게 필요한 권한을 정해요. 예를 들어 **Contents**, **Issues**, **Pull requests**를 **Read-only**로, AI가
   바꿔도 된다면 **Read and write**로 둬요. **Generate token**을 누르고 복사해요. GitHub는 토큰을 한 번만 보여 줘요.
   자세한 내용: [GitHub 안내](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).

2. **Trina AX에 추가하기**

   **관리자 › 연결한 서비스**에서 **주소로 직접 추가**(둘러보기 아래) 또는 **추가**를 눌러요. 이렇게 채워요.

   - **이름**: `GitHub`
   - **주소**: `https://api.githubcopilot.com/mcp/`
   - **고급**을 열고 **인증 방식**을 **API 키**로 정해요.
   - **키를 보낼 헤더**: **Authorization: Bearer (기본)** 그대로 둬요.
   - **키**: 토큰을 붙여 넣어요.

   ![GitHub로 채운 팀 서비스 추가 창: 주소 https://api.githubcopilot.com/mcp/, 키를 보낼 헤더 Authorization: Bearer (기본), 키, 그리고 고급의 팀 공용 키 하나, MCP 서버, API 키, 매번 묻기](../../images/connect/add-by-address-key.webp "토큰으로 연결한 GitHub")

3. **저장하기**

   **저장**을 눌러요. Trina AX가 GitHub에 토큰을 확인하고 쓸 수 있는 도구를 보여 줘요. 줄에 **연결됨**이 떠요.

## 주소로 앱 추가하기

"MCP server" 주소를 공개하는 앱이라면 둘러보기에 없어도 추가할 수 있어요. 팀장과 관리자가 **관리자 › 연결한 서비스** ›
**주소로 직접 추가**에서 해요. 멤버에게는 "목록에 없나요? 관리자에게 추가해 달라고 해 주세요."가 보여요.

> **팁:** **필요한 것**
>
> - **주소**: 그 앱의 도움말에 있어요. 보통 "MCP", "MCP server", "Connect to AI tools" 같은 페이지예요. `https://`로
>   시작하고 `/mcp`로 끝나는 경우가 많아요.
> - 앱이 로그인하는 방식: 앱 페이지에서 로그인(**로그인(OAuth)**), 키(**API 키**), 또는 로그인 없음(**없음**).
> - 키를 쓴다면: 앱 설정("API keys", "Tokens", "Developer")에서 받은 **키**, 그리고 앱 도움말에 나와 있다면 `X-API-Key`
>   같은 **헤더 이름**.

창의 칸은 이래요.

| 칸 | 넣을 것 |
|---|---|
| **이름** | 채팅에서 사람들이 보는 이름. 예: "GitHub" |
| **주소** | 그 앱의 MCP 주소. `https://`로 시작해요. |
| **누가 연결하나요** (고급) | **팀 공용 하나** 또는 **멤버마다 각자** |
| **종류** (고급) | **MCP 서버**. 일반 웹 API일 때만 **API**를 골라요. 자세한 건 [회사 API](/docs/ko/use/api-connections.md)에 있어요. |
| **인증 방식** (고급) | 앱 도움말에 따라 **로그인(OAuth)**, **API 키**, **없음** 중 하나. |
| **키를 보낼 헤더** | 앱 도움말에 다른 헤더가 없으면 **Authorization: Bearer (기본)** 그대로 둬요. 있으면 **다른 헤더**를 고르고 **헤더 이름**을 똑같이 입력해요. |
| **키** | 키 전체를 붙여 넣어요. 저장한 뒤에는 다시 볼 수 없어요. |
| **내 앱으로 로그인** (고급) | Google의 MCP 서버처럼 로그인 앱을 직접 만들라는 앱에만 써요. [내 앱으로 로그인하기](/docs/ko/use/api-connections.md#내-앱으로-로그인하기)에 나와요. |
| **쓰기·삭제·보내기** (고급) | AI가 먼저 물어볼지 정해요(아래 참고). |

> **주의:** 키는 주소(`…?key=…`)가 아니라 **키** 칸에 넣어요. 팀 연결을 쓰는 사람은 그 주소를 볼 수 있고, AI도 주소를 읽어요.

## 바꾸는 일은 허락이 필요해요

읽기는 바로 실행돼요. 나머지는 모두 쓰기이고, 연결의 **쓰기·삭제·보내기** 설정을 따라요.

| 설정 | 일어나는 일 |
|---|---|
| **매번 묻기** (기본) | Trina AX가 보낼 내용을 모두 적은 카드를 보여 줘요. 사람이 허락하기 전에는 아무것도 나가지 않아요. |
| **쓰기 막기** | 찾아보기만 해요. 쓰기는 거절돼요. |
| **묻지 않고 실행** | 쓰기를 묻지 않고 실행해요. 관리자만, 팀 연결에서만 고를 수 있어요. |

연결을 관리하는 사람은 연결 페이지에서 도구를 하나씩 끌 수도 있어요. 앱이 돌려준 내용은 바깥 데이터로 다루고, 지시로
받아들이지 않아요. 예약 작업에서는 허락할 사람이 없어서 쓰기가 거절돼요. 단, 작업 카드에서 허용한 **묻지 않고 실행** 팀
연결은 예외예요.

## 템플릿: 멤버가 각자 자기 키 쓰기

많은 앱이 키에 그 주인의 권한을 주고, 모든 호출을 그 사람 이름으로 기록해요. 이런 앱은 관리자가 **템플릿**을 추가해요.
앱은 한 번만 등록하고, 멤버가 각자 자기 키나 로그인으로 연결해요.

1. **템플릿 추가하기**

   **관리자 › 연결한 서비스**에서 **주소로 직접 추가**를 눌러요(또는 앱 페이지에서 **팀용으로 연결** 옆 화살표 › **템플릿: 멤버가 각자 연결**). **고급**에서 **누가 연결하나요**를 **멤버마다 각자**로 정해요. 주소, 인증 방식, 쓸 사람을
   채워요. 키 칸은 없고, 주소에 `?…` 부분도 넣을 수 없어요. 거기 키가 있으면 모든 멤버에게 가기 때문이에요.
   **직원에게 보일 메모 (선택)** 칸에 키를 어디서 받는지 적어 두면 돼요.

   ![GitHub 템플릿으로 만드는 팀 서비스 추가 창: 여기서는 키를 넣지 않아요, 누가 연결하나요가 템플릿으로 되어 있고, 토큰 만드는 곳을 알려 주는 멤버용 메모](../../images/connect/template.webp "템플릿")

2. **멤버가 연결하기**

   대상 멤버는 **활동**에서 알림을 받고, **설정 › 커넥터**의 **내 커넥터**에서 **팀** 표시와 **연결** 버튼이 붙은 템플릿을
   봐요. 각자 자기 키를 넣거나 로그인해요. 그러면 그 사람만의 연결이 되고, 그 사람 채팅에서만 쓰여요.

| | 팀 연결 (키 하나) | 템플릿 |
|---|---|---|
| 키 | 하나, 관리자가 넣어요 | 멤버마다 각자 |
| AI가 쓰는 권한 | 모두에게 키 주인의 권한 | 멤버마다 자기 권한 |
| 관리자가 보는 것 | 연결 | 누가 언제 연결했는지, 누구 키가 작동하지 않는지. 키는 절대 못 봐요 |

관리자 › 연결한 서비스의 템플릿 줄에서 **템플릿 · N명 연결**을 누르면 대상자가 보여요. **연결됨**, **연결 안 함**,
**키가 작동하지 않음** 중 하나예요. 템플릿이 필요한 예약 작업은 내 키가 없으면 실행되지 않아요. 결과에 "…에 내 키가
필요해요"가 뜨고 **연결**로 가는 링크가 있어요.

멤버는 자기 키나 로그인, 쓰기 설정만 바꿀 수 있고, 언제든 연결을 끊을 수 있어요. 관리자가 템플릿의 주소나 인증 방식을
바꾸면 모든 멤버의 키가 지워지고 다시 연결해야 해요. 이름이나 메모만 바꾸면 모두 연결된 채로 있어요. 템플릿을 지우거나
대상에서 누군가를 빼면 그 사람의 연결도 지워져요.

## 멤버에게 연결 요청하기

관리자는 앱을 채워 둔 요청을 멤버 한 명에게 보낼 수도 있어요. **관리자 › 연결한 서비스** › **추가** 옆 화살표 ›
**멤버에게 연결 요청**이에요. 멤버는 알림을 받고 자기 키로 연결하거나 거절해요. 관리자는 키를 볼 수 없어요.

## 채팅에서 연결하기

채팅에서 "Linear 연결해 줘"라고 부탁해도 돼요. AI가 앱의 공식 주소를 채우고 카드를 보여 줘요. 나는 카드에서 로그인하거나
키만 붙여 넣으면 돼요. 키는 AI에게 가지 않아요.

## 문제가 생기면

| 이런 게 보이면 | 이렇게 해요 |
|---|---|
| **로그인 필요** | 로그인이 끝났거나 앱에서 키를 취소했어요. 연결을 열고 **다시 로그인**이나 **키 바꾸기**를 눌러요. |
| **로그인이 아직 끝나지 않았어요.** | 로그인 창을 닫았거나 다른 창 뒤에 있어요. **로그인 창 열기**를 누르거나, 취소하고 다시 해요. |
| **서비스에서 접근을 허용하지 않았어요.** | 앱 페이지에서 취소나 거부를 눌렀어요. 다시 로그인하고 허용해요. |
| 이유에 "401"이나 "unauthorized"가 있는 **연결을 확인하지 못했어요.** | 키가 틀렸거나 만료됐거나, 복사할 때 공백이 들어갔어요. 앱의 복사 버튼으로 다시 복사해요. Bearer가 아닌 헤더라면 **헤더 이름**을 한 글자씩 확인해요. |
| **이 서비스가 알려 준 도구가 없어요.** | MCP 주소가 아니에요(앱 홈페이지 주소를 붙여 넣은 경우가 많아요). 앱의 MCP 도움말에 있는 주소를 써요. |
| 멤버가 앱을 못 찾아요 | 멤버는 **둘러보기**에 있는 앱만 연결할 수 있어요. 관리자에게 주소로 추가하거나 템플릿으로 추가해 달라고 해요. |

## 반대 방향

내 Claude(Claude Code, Claude Desktop, claude.ai)가 Trina AX**에** 연결해서 내 권한으로 내 파일을 쓸 수도 있어요.
[Team AX MCP 커넥터 알아보기](/docs/agents/mcp-connector.md) (영어).

개발자를 위한 자세한 내용: [Integrations](https://github.com/trina-app/trina-ax/blob/main/docs/INTEGRATIONS.md) (영어).
