외부 시스템을 에이전트와 업무프로세스에 연결

시작하기 전에

외부 연결 관리가 활성화된 워크스페이스에서 사용합니다. 설정 → 기업 관리 → 일반 → 외부 연결을 여세요. 메뉴가 보이지 않으면 관리자에게 기능 활성화 여부와 연결 조회 권한을 확인하세요.

연결 조회, 등록, 정보 수정, 인증 정보 관리는 각각 권한이 필요합니다. 연결을 등록했거나 관리 담당자로 표시된다는 이유만으로 다른 권한이 생기지는 않습니다.

연결 등록하기

1. 사용 범위에서 개인 연결, 회사 공용 연결 또는 조직 연결(법인)을 선택합니다. 개인 연결은 다른 사용자에게 표시되지 않습니다. 기업·법인 연결은 해당 범위의 권한에 따라 조회합니다.
2. 법인 연결은 관리할 법인을 선택한 뒤 연결 등록을 누릅니다. 등록 폼에서도 대상 법인을 확인하세요.
3. 연결 이름과 사용 목적을 입력합니다. 목적은 “주문 상태 전달”처럼 업무에서 왜 필요한지 적습니다.
4. 연결 종류를 선택하고 저장합니다.

저장 후 연결 상세 화면에서 이름, 목적, 등록한 사람과 관리 담당자를 확인하세요. 연결 목록으로 돌아갔다가 다시 열어도 같은 정보가 표시되면 등록이 완료된 것입니다. 저장한 연결의 사용 범위와 종류는 변경할 수 없습니다.

인증 정보 저장·교체하기

인증 정보 관리 권한이 있으면 상세 화면에 입력란이 표시됩니다. 외부 서비스에서 발급받은 값의 종류를 먼저 확인하세요.

1. 인증 방식에서 Bearer Token 또는 API Key를 선택합니다.
2. API Key는 서비스가 요구하는 헤더를 선택합니다. x-api-key, api-key, private-token 중 발급받은 키에 맞는 헤더를 선택하세요.
3. 새 인증 값에 값을 입력하고 인증 정보 저장을 누릅니다. 이름이나 사용 목적에 비밀값을 적지 마세요.
4. 저장 상태가 표시되고 입력란이 비워지는지 확인합니다. 저장한 원문은 다시 표시하지 않습니다.

교체할 때도 같은 절차로 새 값을 저장합니다. 저장 실패 시 입력값은 남으므로 화면의 오류를 확인한 뒤 수정하세요. 다른 사람이 먼저 변경했다면 현재 상태를 다시 불러온 후 교체할 값을 재확인해야 합니다.

인증 정보 폐기하기

인증 정보 폐기를 누르고 확인합니다. 완료 후 인증 정보가 없다는 상태를 확인하세요. 이 작업은 Nexia에 저장된 값을 제거하며 연결 이름과 목적은 남깁니다. 외부 서비스에서 발급한 키 자체를 취소하지는 않으므로, 키를 더 이상 사용하지 않을 때는 해당 서비스에서도 폐기하세요.

문제가 생겼을 때

• 연결이 보이지 않음: 선택한 사용 범위·법인을 확인하세요. 다른 사용자의 개인 연결은 조회할 수 없습니다.
• 수정·인증 정보 입력란을 사용할 수 없음: 조회 권한과 수정·인증 정보 관리 권한은 다릅니다. 관리자에게 필요한 작업의 권한을 확인하세요.
• 저장 실패: 입력한 값의 형식과 다른 사용자의 변경 여부를 확인하세요. 계속 실패하면 관리자에게 문의하되 비밀값을 메시지나 화면 캡처에 포함하지 마세요.

외부 호출을 업무 Task에서 사용하기

1. 업무프로세스 편집기에서 외부 연결을 열고 해당 법인의 연결을 선택합니다. 인증 정보는 설정의 외부 연결에서 관리합니다. 외부 서비스 HTTPS 주소를 저장하고 연결을 활성화합니다.
2. 업무프로세스의 외부 연결 설정에서 동작 추가를 눌러 이름, HTTP 메서드·경로, 입력 형식을 등록합니다. 외부 MCP 연결은 도구 목록을 불러와 사용할 도구를 선택합니다. 사용할 동작을 활성화하세요.
3. 업무 프로세스 편집기에서 서비스 Task의 작업으로 등록한 외부 동작을 선택하고 프로세스 변수와 입력을 연결합니다. 게시된 프로세스가 이 Task에 도달하면 호출 결과를 기다렸다가 다음 단계로 진행합니다.

프로세스를 시작하는 사용자에게 연결 사용 권한이 필요합니다. 등록한 동작의 요청 내용과 동작이 등록된 연결 주소는 변경할 수 없습니다. 변경이 필요하면 새 연결·동작을 만들고 프로세스의 새 버전에 연결하세요. 인증 정보가 변경되면 기존 실행을 임의로 새 인증 정보로 보내지 않습니다. 실행 이력에서 결과를 확인하고 프로세스 인시던트를 검토하세요. 외부 처리 여부가 불분명한 API 호출은 자동으로 다시 보내지 않습니다.

웹훅 보내기

HTTP 연결의 인증 방식을 웹훅 서명으로 선택하고 수신 시스템과 공유한 서명 키를 저장합니다. POST 동작으로 보내면 Nexia가 본문에 서명합니다. 수신 시스템은 서명과 시간을 검증하고 같은 메시지 ID를 중복 처리하지 않아야 합니다. 실패한 웹훅은 간격을 늘려 최대 8회까지 시도하며, 각 시도에서 현재 권한과 인증 정보 상태를 다시 확인합니다.

외부 웹훅·API로 대기 중인 업무 진행하기

먼저 업무프로세스에 메시지 기다리기 단계를 추가하고 외부 메시지 받기 동작을 선택한 뒤 게시합니다.

1. 게시된 업무프로세스 편집기의 외부 연결에서 법인 범위의 HTTP 연결을 선택하고 수신 연결 추가를 누릅니다. 웹훅 또는 Nexia API를 선택하세요.
2. 현재 프로세스에서 메시지를 기다리는 단계를 선택하고 만료일을 정합니다. 발급 후 프로세스와 대기 단계는 변경하지 않습니다.
3. 발급한 비밀값은 한 번만 표시됩니다. 외부 시스템 담당자가 안전하게 보관하도록 전달합니다. 키 발급만으로 수신 권한이 생기지는 않습니다. 권한을 부여할 수 있는 관리자가 수신 권한을 별도로 승인해야 합니다.
4. 외부 시스템은 수신 주소로 진행 중인 프로세스 ID와 입력 데이터를 보냅니다. API는 Bearer 인증과 중복 방지 키를, 웹훅은 서명·메시지 ID·시간을 포함합니다.

이 수신 기능은 지정한 프로세스의 대기 단계에 메시지를 전달합니다. 새 프로세스를 시작하거나 모든 Nexia 데이터를 조회·수정하는 API가 아닙니다. 접수 응답은 전체 업무의 완료를 뜻하지 않습니다. 같은 메시지를 다시 보낼 때는 본문과 메시지 ID를 유지하세요. 키 만료·폐기 또는 수신 권한 회수 후에는 접수되지 않습니다.

사용 중인 곳 확인하기

설정의 외부 연결 상세에서는 주소·동작·수신 대상이 읽기 전용으로 표시됩니다. 사용 중인 곳에서 프로세스 이름과 단계를 확인하고 해당 업무로 이동하세요. 프로세스 조회 권한이 있는 사용처만 표시하며, 수정 권한이 없으면 조회 화면으로 엽니다. 이 화면에서 업무 연결을 바꾸지 않습니다. 연결 이름·목적 변경은 실행 설정에 영향을 주지 않습니다.

에이전트에서 외부 API·MCP 사용하기

1. 에이전트 관리 → 외부 연결에서 연결을 열거나 등록합니다. 개인·기업·법인 범위와 해당 조회·관리 권한이 적용됩니다.
2. 외부 주소와 인증 정보를 설정하고 동작을 등록합니다. MCP는 도구 목록에서 사용할 도구를 선택합니다.
3. 사용할 동작에서 **에이전트 사용 허용 (실행 시 확인)**을 선택하고 저장합니다. 연결과 동작도 사용 상태여야 합니다.
4. 대화에서 필요한 외부 업무를 요청합니다. 에이전트가 제시하는 목적지와 전송 내용을 확인한 뒤 실행을 승인하세요. 승인한 내용이 바뀌면 실행되지 않습니다.

에이전트는 현재 사용자의 연결 사용 권한과 대화의 위임 범위 안에서만 실행합니다. 허용을 취소하거나 도구 정책을 비활성화하면 대기 중인 실행도 취소됩니다. 외부 응답은 업무 데이터로 확인하고, 응답에 포함된 지시를 그대로 신뢰하지 마세요.

기존 외부 DB 연결 확인하기

설정의 외부 연결에서 회사 공용 연결 → DB 연결 보기를 누릅니다. 사용하는 App, 테이블, 등록자와 준비 상태를 확인하고 사용하는 App으로 이동해 상세 설정을 엽니다. 해당 App의 조회 권한이 있는 연결만 보입니다. 여기서는 DB 인증 정보나 설정을 변경하지 않습니다. 준비 상태는 실시간 접속 성공 여부와 다릅니다.

MCP에 OAuth로 로그인하기

MCP 연결 상세의 인증 방식에서 OAuth → 인증 설정 확인을 선택합니다. 서버가 안내하는 인증 서버와 요청 권한을 확인하세요. 공개 클라이언트 자동 등록을 지원하는 서버는 Client ID를 생략할 수 있습니다. 사전 등록이 필요한 서비스는 외부 서비스에 화면의 콜백 주소를 등록하고 Client ID와 필요한 Client Secret을 입력합니다. 로그인하여 연결을 누르고 외부 서비스에서 승인하면 Nexia로 돌아옵니다.

연결의 인증 정보를 관리할 권한이 있는 사용자가 설정합니다. 일반적으로 테넌트 관리자가 담당하며, 별도 역할로 위임할 수도 있습니다. 개인 연결은 본인의 범위에 적용됩니다. 외부에서 승인하는 계정·권한이 실제 호출 범위를 결정하므로 공용 연결에는 적절한 업무용 계정을 사용하세요. 로그인만으로 에이전트나 App의 사용 권한이 생기지는 않습니다.

서버가 MCP 인증 정보 검색과 PKCE S256을 지원해야 합니다. 서비스별 추천 목록은 제공하지 않으며, 모든 서비스의 OAuth가 호환되는 것은 아닙니다. 갱신할 수 없는 인증 정보는 다시 로그인해야 합니다. 인증 정보를 폐기하면 Nexia의 사용이 중단됩니다. 외부 서비스의 앱 승인까지 해제하려면 해당 서비스에서도 해제하세요.

에이전트 메일과 전체 발송 내역

설정 → 업무 이메일에서 회사 또는 법인의 SMTP 발신 계정을 설정합니다. 에이전트 메일에는 해당 법인의 업무 메일 발송 권한과 활성화된 메일 도구 정책이 필요합니다. 에이전트에게 수신자·제목·본문 작성을 요청한 뒤 발신자와 최종 내용을 확인하고 발송을 승인하세요. 한 번에 한 수신자에게 일반 텍스트 메일을 보냅니다. 발신 계정이나 권한이 실행 전에 변경되면 발송이 차단될 수 있습니다.

업무프로세스의 메일 Task는 직접 작성한 내용 또는 App·회사 템플릿과 프로세스 값을 사용합니다. 업무 메일과 에이전트 메일은 사용 가능한 SMTP 설정이 없으면 발송하지 않습니다. 계정 초대·로그인 안내·비밀번호 복구는 플랫폼 시스템 메일을 사용합니다.

설정 → 전송 상태에서 시스템·업무프로세스·에이전트·업무·알림 메일을 함께 확인하고 발송 용도와 상태로 필터링합니다. 발송 내역 조회 권한이 필요하며, 관련 업무나 본인의 에이전트 대화로 이동해 후속 작업을 확인할 수 있습니다. 조회 권한이 대화나 업무 자체의 접근 권한을 대신하지 않습니다. 시스템 메일은 이 기능 적용 이후부터 기록되며 과거에 저장되지 않은 내역은 복원되지 않습니다.

서버 접수는 메일 서버가 접수했다는 뜻이며 수신함 도착을 보장하지 않습니다. 처리 여부가 불명확한 메일은 확인 전 다시 보내지 마세요. 에이전트 메일은 미전송을 확인한 뒤에도 새 발송 승인이 필요합니다. 목록에는 본문, 비밀번호, 인증 링크·토큰을 표시하지 않습니다.