회사마다 직접 운영하는 시스템이 있어요. 프로젝트 관리 도구, 주문 시스템, 사내 도구 같은 것들이에요. 웹 API가 있다면 AI가 쓸 수 있어요. 팀장이나 관리자가 관리자 › 연결한 서비스에서 주소, 키, 사용법 몇 줄을 넣어 한 번 추가하면 돼요. 그러면 AI는 그 주소 아래에 있는 주소만 호출할 수 있어요.
NAVER WORKS 같은 서비스는 키를 주지 않아요. 회사가 그 서비스에 만든 로그인 앱을 거쳐 각자 로그인해요. 이 페이지의 뒷부분에서 설명해요.
아래 값을 받으려면 그 시스템을 잘 아는 사람(시스템 관리자나 개발자)이 있어야 해요. 코드를 짤 필요는 없어요.
#키로 API 연결하기
필요한 것
- 주소: API의 기본 주소예요. 예:
https://pm.acme.example/api/v1. 시스템 관리자에게 묻거나 API 문서("base URL")를 찾아봐요. - 키: 그 시스템의 API 키나 토큰. Trina AX 전용으로 하나 만들고, AI에게 필요한 만큼만 권한을 줘요.
- 키를 보낼 헤더: 대부분의 API는
Authorization: Bearer <key>를 받아요. API 문서에X-API-Key같은 다른 헤더가 나와 있으면 정확한 이름을 적어 둬요. - 사용법 메모: AI가 어떤 주소를 호출해야 하는지 적은 몇 줄. 시스템의 API 문서에 나와 있어요.
- 창 열기
관리자 › 연결한 서비스에서 둘러보기 아래의 주소로 직접 추가를 눌러요. 고급을 열고 종류를 API로, 인증 방식을 API 키로 정해요.
- 칸 채우기
- 이름: 채팅에서 사람들이 보는 이름. 예: "AI PM"
- 주소: 기본 주소. AI는 이 주소 아래의 경로만 호출할 수 있어요.
- 키를 보낼 헤더: Authorization: Bearer (기본) 그대로 두거나, 다른 헤더를 고르고 헤더 이름을 문서에 적힌 그대로 입력해요.
- 키: 키를 붙여 넣어요.
- 사용법 메모: 주요 경로, 필요한 값, AI가 하면 안 되는 일. 4,000자까지 쓸 수 있어요.
키로 연결한 API - 쓸 사람 고르고 저장하기
쓸 사람: 팀 전체 · 바꾸기에서 부서나 사람을 골라요. 쓰기·삭제·보내기는 처음에는 매번 묻기로 둬요. 저장을 누르면 Trina AX가 주소와 키를 확인하고, 줄에 연결됨이 떠요.
사용법 메모는 이렇게 쓰면 좋아요.
List projects with GET /projects.
Create a task with POST /tasks and a JSON body {"projectId", "title", "dueDate"}.
Dates are YYYY-MM-DD. Never call DELETE.
AI는 API를 쓸 때마다 이 메모를 읽어요. 짧고 정확하게 써야 해요.
#내 앱으로 로그인하기
어떤 서비스는 로그인(OAuth)을 허용하지만, 그 서비스에 등록한 앱을 거쳐야만 해요. NAVER WORKS와 Google의 MCP 서버가 그래요. 서비스의 개발자 콘솔에서 앱을 한 번 만들고, 그 값을 Trina AX에 붙여 넣어요. 보통은 템플릿으로 추가해서 멤버가 각자 자기 계정으로 로그인하게 해요.
서비스의 개발자 콘솔에서 받을 것
- 거기서 만든 앱의 Client ID와 Client Secret.
- 로그인 주소와 토큰 주소 (API일 때. MCP 서버는 알아서 찾아요).
- 권한 범위(scope): AI에게 필요한 권한. 공백으로 구분해요.
서비스에 넣을 것
- Trina AX가 보여 주는 리디렉션 주소:
https://<your team address>/api/integrations/oauth/callback
- Trina AX에서 창부터 열기
관리자 › 연결한 서비스에서 주소로 직접 추가를 누르고 고급을 열어요. 누가 연결하나요는 멤버마다 각자, 종류는 API(또는 MCP 서버), 인증 방식은 로그인(OAuth) 항목으로 정해요. MCP 서버라면 내 앱으로 로그인도 켜요. 그러면 창에 서비스의 앱 설정에 등록할 리디렉션 주소가 복사 버튼과 함께 보여요. 복사해 둬요.
- 서비스에서 앱 만들기
서비스의 개발자 콘솔에서 앱을 만들어요("OAuth app", "client", "integration" 같은 이름일 수 있어요). 리디렉션 주소를 redirect URL 칸에 붙여 넣고, scope를 고른 뒤, Client ID와 Client Secret을 복사해요.
- 나머지를 채우고 저장하기
Trina AX로 돌아와 이름, 주소, Client ID, Client Secret, 로그인 주소와 토큰 주소(API일 때), 권한 범위(scope) 칸을 채워요. 템플릿 만들기를 눌러요. 그러면 멤버가 설정 › 커넥터에서 이 앱을 보고 자기 계정으로 로그인해요.
내 앱으로 로그인하기
#NAVER WORKS
| Trina AX의 칸 | 값 |
|---|---|
| 종류 | API |
| 주소 | https://www.worksapis.com/v1.0 |
| 로그인 주소 | https://auth.worksmobile.com/oauth2/v2.0/authorize |
| 토큰 주소 | https://auth.worksmobile.com/oauth2/v2.0/token |
| Client ID, Client Secret | NAVER WORKS Developer Console의 내 앱에서 받아요 |
| 권한 범위(scope) | AI에게 필요한 권한. 예: calendar mail file user.read |
| 사용법 메모 | AI가 호출할 API 주소. NAVER WORKS API 문서에 있어요 |
NAVER WORKS Developer Console에서 내 앱을 열고(없으면 API 2.0에서 추가해요), Redirect URL을 Trina AX가 보여 주는 주소로 정해요. 같은 OAuth Scopes에 체크하고 Client ID와 Client Secret을 복사해요. 로그인 방식은 NAVER WORKS의 OAuth 안내에 나와 있어요.
#Google의 MCP 서버
Google도 Gmail, Calendar, Drive 등을 위한 MCP 서버(https://gmailmcp.googleapis.com/mcp/v1 같은 주소)를 Google의
미리보기 프로그램으로 내놓고 있어요. 이 서버를 쓰려면 Google 로그인 앱을 직접 만들어야 해요.
회사의 Google 앱처럼 만들되, 리디렉션 주소만 위의 주소로 넣어요. 평소에는 앱을
따로 만들 필요 없는 기본 Google 앱을 쓰면 돼요.
#문제가 생기면
| 이런 게 보이면 | 이렇게 해요 |
|---|---|
| 서비스가 이 앱의 Client ID나 Secret을 받아들이지 않았어요. | Client ID나 Secret을 잘못 복사했거나, 서비스에서 Secret을 새로 만들었어요. 연결을 편집해 고급에서 Secret을 다시 넣고 다시 로그인해요. |
서비스가 리디렉션 주소가 틀렸다고 해요 (redirect_uri_mismatch, "invalid redirect") | 서비스 콘솔의 redirect URL이 Trina AX에 보이는 주소와 달라요. 복사 버튼으로 다시 복사하고 https, 팀 주소, 끝에 슬래시가 없는지 확인해요. |
| 다른 주소로 옮기면 저장된 Client Secret은 따라가지 않아요. 다시 넣어 주세요. | 주소나 로그인 주소를 바꿨어요. 안전을 위해 Secret을 다시 쓰지 않아요. 다시 붙여 넣어요. |
| 호출하면 401이나 403이 돌아와요 | 키가 만료됐거나 권한이 모자라거나, 복사할 때 공백이 들어갔어요. 새 키를 만들거나, 서비스에서 빠진 scope를 더하고 다시 로그인해요. |
| AI가 엉뚱한 경로를 호출해요 | 사용법 메모를 더 정확하게 써요. 경로마다 메서드를 함께 적어요. |
개발자를 위한 자세한 내용: Integrations (영어).