
Air Pipe認証済み注目
@airpipe
Air Pipe について
Build, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client.
接続情報
https://api.airpipe.io/mcpセットアップ
claude mcp add airpipe --transport http https://api.airpipe.io/mcp --header "Authorization: Bearer YOUR_AIRPIPE_MCP_TOKEN"ツール
19Create a reusable module (a typed config fragment referenced by handle) and optionally deploy it to staging or production. spec_yaml is base64-encoded YAML of the module body; module_type is the config struct it represents (e.g. Database).
Get airpipe config-authoring instructions plus RAG-retrieved real action examples for a natural-language request, so YOU (the calling model) write the YAML yourself instead of the server generating it. Returns { instructions, context, request, protocol }. After writing the config, validate it with the validate_config tool (repair loop) then persist it with create_config. Prefer this over generate_config whenever you can author YAML yourself.
Enable or disable one or more configurations by config_uuid.
Edit an AirPipe configuration YAML with a natural-language instruction.
Deploy a specific past revision of a configuration to staging or production.
List the organizations you belong to and their organization_uuid. Call this first to get an organization_uuid for the config tools.
Undeploy a reusable module from an environment (STAGING or PRODUCTION).
Deploy a specific past revision of a module to staging or production.
Update an existing reusable module by module_uuid (adds a new revision; spec_yaml is base64-encoded YAML) and optionally redeploy.
Get a single configuration's data by config_uuid, optionally with its revisions.
List the organization's AirPipe configurations.
Create a new AirPipe configuration (config_yaml is base64-encoded YAML) and optionally deploy it to staging or production.
List the organization's reusable modules (pass revisions=true to include revision history).
Delete one or more reusable modules by module_uuid.
Get a single reusable module by uuid, including its revision history and spec.
Update an existing AirPipe configuration by config_uuid (config_yaml is base64-encoded YAML) and optionally redeploy.
Schema-validate an airpipe YAML config. Send { "yaml": <the full YAML string> }. Returns { valid: true } when it passes, or { valid: false, error: <message> } when it fails — feed the error back into your fix and call again until valid. Schema check only; does not save. Use create_config to persist a valid config.
Delete one or more AirPipe configurations by config_uuid.
Undeploy a configuration from an environment (STAGING or PRODUCTION).
概要
Air Pipe turns one declarative config into a running backend — HTTP routes, cron jobs, webhooks, realtime channels and MCP tools, all from the same interface and behind the same auth.
This server hands that platform to your AI client. Claude Code, Claude Desktop or Cursor can plan a service, write the config, validate it, deploy it to staging or production, and roll it back — end to end, without leaving the chat.
The authoring loop
The interesting tool is plan_config, and it deliberately does not generate YAML server-side.
It returns config-authoring instructions plus real action examples retrieved for your request, and
your model writes the config. That keeps the output in your model's context where you can reason
about it, rather than handing back a black box.
plan_config— instructions + retrieved examples for what you asked for- your model writes the YAML
validate_config— schema check; feed the error back and retry until it passescreate_config— persist it, optionally deploying in the same calldeploy_config_revision— promote or roll back to any past revision
Step 3 is a repair loop, not a gate. validate_config returns the specific schema error so the
model can fix and re-submit, which is why generated configs converge instead of failing opaquely.
Tools
Discovery
| Tool | Does |
|---|---|
list_organizations | Your orgs and their organization_uuid. Call this first — the config tools need it. |
list_configs | The org's configurations. |
get_config | One configuration, optionally with its revision history. |
Authoring
| Tool | Does |
|---|---|
plan_config | Authoring instructions + retrieved examples so your model can write the config. |
validate_config | Schema-validate YAML. Returns the exact error to repair against. |
create_config | Persist a config, optionally deploying it. |
update_config | Update by uuid, adding a revision, optionally redeploying. |
edit_config | Apply a natural-language edit to an existing config. |
Lifecycle
| Tool | Does |
|---|---|
deploy_config_revision | Deploy any past revision to staging or production — this is your rollback. |
undeploy_config | Remove a config from an environment. |
toggle_config | Enable or disable configs. |
delete_config | Delete configs. |
Reusable modules — typed config fragments referenced by handle, so shared pieces (a database
block, a common action) live in one place: list_modules, get_module, create_module,
update_module, deploy_module_revision, undeploy_module, delete_module.
19 tools in total.
Setup
- Create an account at https://app.airpipe.io/register — the free tier is 3,000 managed request units a month, no card.
- Mint an MCP token from your account. It is a long-lived JWT (90 days by default), shown once, and revocable at any time.
- Add the server:
{
"mcpServers": {
"airpipe": {
"type": "http",
"url": "https://api.airpipe.io/mcp",
"headers": { "Authorization": "Bearer YOUR_AIRPIPE_MCP_TOKEN" }
}
}
}
Ask your client to list_organizations to confirm the connection.
Security
Every tool validates the token, then checks org membership, then role — three layers, and they fail closed. An agent reaches exactly what you could reach yourself with that token, and nothing more.
Tool discovery is open (registries need it), but every tool call is authenticated. Tokens are revocable by id without waiting for expiry.
What you get on the other end
A config deployed through these tools is a real service: OpenAPI docs, Prometheus metrics and OpenTelemetry traces generated from the same file, over Postgres, MySQL, SQL Server, SQLite or MongoDB. Run it on Air Pipe's managed cloud, or self-host the identical config as a single binary — the self-hosted binary serves this same MCP interface.
- Site: https://airpipe.io/
- Docs: https://docs.airpipe.io/
- Marketplace packs: https://docs.airpipe.io/marketplace
よくある質問
Air Pipe のリモート MCP サーバーとは何ですか?
Air Pipe のリモート MCP サーバーは、https://api.airpipe.io/mcp にホストされた Model Context Protocol エンドポイントです。AI アシスタントはローカルに何もインストール・実行することなく接続できます。
Air Pipe の MCP サーバーにはどう接続しますか?
エンドポイント https://api.airpipe.io/mcp を Claude Code、Cursor、VS Code など任意の MCP 対応クライアントに追加してください。このページのセットアップ手順で各クライアントを一度に設定できます。
Air Pipe の MCP サーバーは認証が必要ですか?
はい。Air Pipe は API キーが必要です——取得方法は公式ドキュメントを確認し、クライアントの設定に追加してください。
Air Pipe の MCP サーバーはどのトランスポートを使用しますか?
Air Pipe は Streamable HTTP エンドポイントを公開しており、これはリモート MCP サーバーで広く使われ、主要な MCP クライアントがサポートするトランスポートです。
基本情報
コメント