每个 SaaS 都要写的 API 集成代码，Nango 帮你干掉了 90%

每个 SaaS 都要写的 API 集成代码，Nango 帮你干掉了 90%

做过 SaaS 集成的，都知道这块有多脏。先收藏，回头一定用得上。

我第一次对接第三方 API 的时候，光是 OAuth 2.0 的 token 刷新逻辑就折腾了两天。后来才知道，每个 SaaS 团队都在重复造这个轮子——GitHub OAuth、Slack OAuth、HubSpot OAuth……每个 API 的认证方式还不一样，有的用 OAuth 1.0，有的用 API Key，有的用 Basic Auth。

Nango 就是来终结这种重复劳动的。它是一个开源的产品集成平台，GitHub 上接近 1 万颗星，把 API 集成里最脏最累的活全揽了——认证、代理、自定义函数，还支持 AI 自动生成集成代码。

本文提纲

1. Nango 是什么？解决什么问题？
2. 三大核心能力：Auth、Proxy、Functions
3. AI Builder：用自然语言生成集成代码
4. 对 AI Agent 的支持：MCP 和 Tool Calling
5. 技术架构和开源生态
6. 什么时候该用 Nango？

Nango 是什么？解决什么问题？

用一句话概括：Nango 是 SaaS 产品集成的基础设施层。

如果你的产品需要连接 Salesforce、HubSpot、Slack、GitHub 等外部 API——不管是为了数据同步、操作执行还是 AI Agent 调用——你都得处理认证、token 管理、请求代理、错误重试、速率限制这些底层问题。Nango 把这些全部抽象成了三个核心原语，覆盖了几乎所有的集成场景。

实际效果：Replit、Ramp、Mercor 等几百个团队已经在生产环境跑 Nango 处理数十亿次 API 请求。

项目关键数据：

指标	数据
GitHub Stars	9,881
Forks	1,022
支持 API 数量	800+
主要语言	TypeScript (8.3M 行)
最新版本	v0.70.6
开源协议	Elastic License
创建时间	2020 年 4 月

三大核心能力：Auth、Proxy、Functions

Nango 把产品集成抽象成三个原语，每个都独立可用，也可以组合使用。

Auth：认证即服务

这是最省心的一块。Nango 预置了 800+ API 的认证配置，支持 OAuth 1.0/2.0、API Key、Basic Auth、JWT 等十几种认证模式。你不需要去读每个 API 的认证文档，不需要自己写 token 刷新逻辑，不需要管理密钥存储。

// 在前端嵌入认证 UI
nango.openConnectUI({ 
  onEvent: (event) => { /* 处理授权完成回调 */ } 
});

几行代码就能在你的产品里嵌入一个白标的连接界面，用户点一下就完成 OAuth 授权，token 自动存储和刷新。多租户？每个连接独立隔离，开箱即用。

Proxy：请求代理

拿到 token 只是第一步，真正烦人的是发请求时的各种边界情况——速率限制、重试策略、错误处理。Nango 的 Proxy 模块帮你处理了这些：

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

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

// 通过代理发送请求，自动注入凭证、处理重试和速率限制
const response = await nango.get({
    endpoint: '/v3/contacts',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

请求经过 Nango 代理后，自动注入认证凭证、处理重试和速率限制，并记录完整的请求日志用于调试。

Functions：自定义集成逻辑

Auth 和 Proxy 解决了"连接"的问题，Functions 解决的是"业务逻辑"的问题。你用 TypeScript 写集成函数，部署到 Nango 的运行时：

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;
}

Functions 支持三种模式：
- Syncs：定时同步数据，支持单向和双向
- Actions：代表用户执行操作（如创建 issue、发送消息）
- Webhooks：接收并处理外部 API 的 webhook 回调

AI Builder：用自然语言生成集成代码

这是 Nango 最有意思的能力。你不需要手写 Functions 代码，用自然语言描述你的需求，AI Builder 就能生成对应的 TypeScript 集成函数。

关键区别：Nango 生成的不是黑盒，而是可读、可编辑、可版本控制的代码。你可以审查、修改，享受完整的类型安全和内置测试框架。

这比那些"No-Code 集成平台"强在哪？你拿到的是真正的代码，不是拖拽出来的不可调试的配置。出了问题你能看懂，能改，能 debug。

对 AI Agent 的支持：MCP 和 Tool Calling

在 AI Agent 爆发的 2026 年，Nango 的定位格外有意思。它天然适合作为 AI Agent 的"手和脚"——让 Agent 能通过 API 操作外部系统。

具体来说，Nango 支持：
- MCP (Model Context Protocol)：把外部 API 暴露为 AI Agent 可调用的工具
- Tool Calling：给 AI Agent 提供操作外部 API 的能力
- 兼容主流 Agent SDK（LangChain、Claude Code、Cursor 等）

这意味着如果你的产品有 AI Agent，你可以用 Nango 快速给 Agent "装上"对 Salesforce、Slack、GitHub 等系统的操作能力，而不需要自己一个个对接。

技术架构和开源生态

Nango 是一个 TypeScript monorepo，包含 20+ 个 package：

核心模块	说明
@nangohq/server	主服务，处理 API 请求和认证
@nangohq/runner	Functions 运行时
@nangohq/providers	800+ API 提供商配置
@nangohq/jobs	任务调度和执行
@nangohq/persist	数据持久化层
@nangohq/node	Node.js SDK
@nangohq/frontend	前端 SDK（连接 UI）

架构上采用微服务设计，支持弹性扩缩容、每租户隔离、自动重试和速率限制。你可以选择用 Nango Cloud（托管服务），也可以自托管在自己的基础设施上。安全合规方面，通过了 SOC 2 Type II、HIPAA 和 GDPR 认证。

前 5 位核心贡献者：

贡献者	提交数
khaliqgant	1,102
bodinsamuel	963
hassan254-prog	840
TBonnin	775
bastienbeurier	526

团队保持了很高的开发活跃度，最新版本 v0.70.6 发布于 2026 年 6 月 1 日，仓库每天有更新。

什么时候该用 Nango？

适合用的场景：

• 你的 SaaS 产品需要对接 3 个以上外部 API
• 你在构建 AI Agent，需要让它操作外部系统
• 你不想在每个 API 上重复实现 OAuth 和 token 管理
• 你需要给用户提供"连接你的 [工具名] 账号"的功能
• 你在做数据同步管道（ETL / Reverse ETL）

可能不太适合的场景：

• 只对接一两个简单的 API（自己写更快）
• 需要极致的请求延迟控制（代理层会加一点开销）
• 你的 API 对接需求非常定制化，不在那 800+ 预置列表里（不过可以自己加 provider）

你的 SaaS 对接了多少个外部 API？最头疼的是哪个？评论区聊聊，看看是不是大家都在踩同样的坑。觉得有用的话，点个赞让更多人看到。

---

作者: itech001
来源: 公众号：AI人工智能时代
网站: https://www.theaiera.cn/
每日分享最前沿的AI新闻资讯和技术研究。

本文首发于 AI人工智能时代，转载请注明出处。