Nango: AI 에이전트와 제품을 800여 개 API에 연결하는 통합 플랫폼

읽을거리&정보공유
, , , , , ,
1

Nango: AI 에이전트와 제품을 800여 개 API에 연결하는 통합 플랫폼
Nango: AI 에이전트와 제품을 800여 개 API에 연결하는 통합 플랫폼1536×1024 221 KB

Nango 소개

외부 서비스와 연동하는 기능을 제품에 붙이는 일은 거의 모든 SaaS 개발에서 반복적으로 등장하지만, 막상 손대 보면 단순하지 않습니다. OAuth 플로우와 토큰 갱신, API 키 저장, 멀티 테넌트 환경에서의 연결 관리, 속도 제한과 재시도 처리까지 직접 구현하다 보면 정작 제품의 핵심 로직보다 연동 코드에 더 많은 시간을 쓰게 됩니다. 여기에 최근에는 AI 에이전트가 외부 API를 직접 호출해 작업을 수행하는 패턴까지 더해지면서, 연동 계층을 다루는 부담은 오히려 커지고 있습니다.

Nango는 이런 제품 통합(Product Integration)을 한곳에서 다루기 위한 플랫폼입니다. 800여 개의 외부 API에 대한 인증과 요청, 실행 로직을 표준화된 방식으로 제공하며, 백엔드 언어나 프레임워크에 종속되지 않고 AI 코딩 도구·에이전트 SDK와도 함께 동작합니다. 연동 로직을 타입스크립트(TypeScript) 함수로 직접 작성하거나, 자연어 설명을 주면 AI가 그 함수를 생성하도록 맡길 수 있고, 작성된 코드는 Nango가 운영하는 프로덕션 런타임에 배포되어 인증·실행·확장·관측(Observability)을 함께 처리합니다.

Nango는 Replit, Ramp, Mercor를 비롯한 여러 회사의 프로덕션 환경에서 사용되고 있습니다. 이 글에서는 Nango가 제공하는 세 가지 통합 기본요소와 동작 흐름, 설치와 사용 방법, 그리고 라이선스를 정리합니다.

Nango의 동작 흐름

Nango는 제품과 AI 에이전트가 외부 API와 통신할 때 그 사이에 들어가는 중간 런타임 역할을 합니다. 애플리케이션은 자격 증명을 직접 다루지 않고 Nango에 요청을 보내며, Nango가 공급자(provider)를 식별하고 자격 증명을 주입한 뒤 응답을 돌려줍니다.

Nango의 동작 흐름 다이어그램
Nango의 동작 흐름 다이어그램1536×1024 253 KB

Nango의 세 가지 통합 기본요소

Nango는 모든 통합 패턴을 세 가지 기본요소(primitive)로 다룹니다. 인증(Auth), 프록시(Proxy), 함수(Functions)이며, 각각 자격 증명 관리, 요청 대행, 사용자 정의 로직 실행을 담당합니다.

인증 (Auth)

800여 개 API에 대한 OAuth, API 키, 토큰 갱신을 Nango가 관리합니다. 화이트 라벨 인증 플로우를 애플리케이션 프론트엔드에 그대로 임베드할 수 있으며, 자격 증명 저장과 토큰 관리, 멀티 테넌트 연결 관리는 Nango가 맡습니다.

// 프론트엔드에 인증 플로우 임베드
nango.openConnectUI({ onEvent: (event) => { /* handle completion */ } });

프록시 (Proxy)

사용자를 대신해 인증된 API 요청을 보냅니다. 요청을 Nango 프록시로 보내면 공급자를 식별해 자격 증명을 주입하고, 재시도와 속도 제한을 처리한 뒤 응답을 반환합니다.

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

// 어떤 API든 인증된 요청을 보낼 수 있습니다
const response = await nango.get({
    endpoint: '/v3/contacts',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

함수 (Functions)

통합 로직을 타입스크립트 함수로 작성해 Nango에 배포합니다. 함수는 API 접근, 재시도, 스토리지, 관측 기능이 내장된 프로덕션 런타임에서 실행됩니다. 사용 사례를 자연어로 설명하면 AI 빌더(AI builder) 가 이 함수를 대신 생성해 줍니다.

export default async function run(nango: Nango) {
    const { owner, repo, title, body } = nango.input;

    const response = await nango.post({
        endpoint: `/repos/${owner}/${repo}/issues`,
        data: { title, body }
    });

    return response.data;
}

Nango로 만들 수 있는 통합 패턴

Nango는 일반적인 통합 패턴 대부분을 지원하며, AI 에이전트가 외부 API를 호출하도록 도구(tool)를 제공하는 작업도 그중 하나입니다. 아래는 공식 문서가 정리한 주요 사용 사례입니다.

사용 사례 설명
AI 도구 호출 및 MCP AI 에이전트가 외부 API를 실제로 호출해 작업을 수행하도록 도구를 제공
데이터 동기화 RAG 파이프라인, 인덱싱, 트리거를 위한 단방향 또는 양방향 동기화
웹훅 처리 외부 API에서 오는 웹훅을 안정적으로 수신하고 처리
API 통일 서로 다른 API를 자체 통합 스키마로 정규화
액션 사용자를 대신해 데이터를 쓰고 작업을 실행
고객별 설정 고객마다 통합 동작을 다르게 구성

Nango 설치 및 사용법

Nango는 클라우드(Nango Cloud)에 가입해 바로 쓰거나, 자체 인프라에 셀프 호스팅(self-hosting)할 수 있습니다. 클라우드 기준으로 통합을 만들고 API에 연결하는 과정은 다음과 같습니다.

먼저 가입 후 Integrations 탭에서 새 통합을 설정하고, Connections 탭에서 연결을 만들어 인증 플로우를 완료합니다. 이렇게 만든 인증 플로우는 이후 제품에 그대로 임베드할 수 있습니다.

nango.openConnectUI({ onEvent: (event) => { /* handle completion */ } });

연결이 만들어지면 자격 증명을 가져와 인증된 요청을 보낼 수 있습니다.

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const connection = await nango.getConnection('<INTEGRATION-ID>', '<CONNECTION-ID>');
console.log(connection.credentials);

Nango는 CLI와 API로 전부 조작할 수 있으며, Cursor·Codex·Claude Code 같은 AI 코딩 도구와 MCP·LangChain 같은 에이전트 SDK와 호환됩니다.

Nango를 선택하는 이유

Nango가 강조하는 차별점은 "AI가 생성하지만 사람이 제어하는 코드" 입니다. AI 빌더가 자연어로부터 타입스크립트 통합 함수를 생성하되, 블랙박스 형태가 아니라 검토·수정·버전 관리가 가능한 코드를 그대로 내준다는 점입니다. 타입 안전성과 내장 테스트 프레임워크도 함께 제공된다고 설명합니다.

저자는 Nango 런타임이 테넌트별 격리, 탄력적 확장, 자동 재시도, 속도 제한 처리를 제공하며 수십억 건의 API 요청을 처리한다고 밝히고 있습니다. 또한 SOC 2 Type II, HIPAA, GDPR을 준수한다고 명시하고 있어, 자격 증명과 외부 연동을 다루는 도구에서 중요한 운영 요건을 함께 고려한 것으로 보입니다.

Nango의 라이선스

Nango는 Elastic License로 공개되어 있습니다. 소스 코드를 자유롭게 열람하고 자체 인프라에서 셀프 호스팅할 수 있지만, Elastic License는 OSI 승인 오픈소스 라이선스와 달리 관리형 서비스 형태로 제3자에게 제공하는 등의 사용에 제약이 있으므로, 상업적 활용을 계획한다면 라이선스 원문을 직접 확인하는 것이 좋습니다. 클라우드와 엔터프라이즈 셀프 호스팅 버전은 모든 기능을 제공하며, 기능이 제한된 무료 셀프 호스팅도 가능합니다.

:house: Nango 공식 홈페이지

:books: Nango 문서 사이트

:github: Nango 프로젝트 GitHub 저장소

더 읽어보기



이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. :hugs:

:pytorch:파이토치 한국 사용자 모임:south_korea:이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일:love_letter:로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)

:wrapped_gift: 아래:down_right_arrow:쪽에 좋아요:+1:를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ :star_struck:

Open Agent SDK: CLI 없이 프로세스 내에서 실행되는 오픈소스 에이전트 SDK