技能版本 1.0.0

API Gateway

通过 Maton 管理的 API 路由连接外部服务;仅在用户指定目标应用、账户和任务后使用;以读取/列...

价格

免费

  • 安装:免费

在组织开通时一次性收取;再次读取清单或下载不重复收费。

以上为公开标价。你的组织可能有协议价,以控制台显示的价格为准。

如何使用

  1. 为组织安装

    开通即安装:组织固定使用开通时的版本(当前为 1.0.0)。升级到新版本需要取消后重新开通。

  2. 创建凭证

    客户端使用组织凭证读取;绑定到数字人后,数字人使用绑定凭证按需加载。请求中携带:

    Authorization: Bearer $ZGI_MARKET_KEY

  3. 读取清单与安装包

    清单列出版本、文件和校验值;安装包是一个 zip 文件。

    读取清单
    curl "https://market-api.zgi.im/v1/market/skills/api-gateway/manifest" \
      -H "Authorization: Bearer $ZGI_MARKET_KEY"
    下载安装包
    curl "https://market-api.zgi.im/v1/market/skills/api-gateway/package" \
      -H "Authorization: Bearer $ZGI_MARKET_KEY" \
      -o api-gateway.zip

    读取清单和下载安装包不计入用量。下载后请用响应头中的 SHA-256 校验文件。

技能说明

名称
api-gateway
说明
Connect to external services through Maton-managed API routes. Use this skill only after the user names the target app, account, and task. Start with read/list calls when possible and follow the app-specific reference before any change.
仅指令

技能包内没有脚本文件:这个技能是供模型阅读的文本。

SKILL.md 节选

# API Gateway

Managed API routing for third-party services, provided by [Maton](https://maton.ai). Use this only for a user-requested app, account, and task.

## Quick Start

**CLI:**

```bash
maton slack channel list --types public_channel --limit 10
```

```bash
maton api '/slack/api/conversations.list?types=public_channel&limit=10'
```

**Python:**

```bash
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/slack/api/conversations.list?types=public_channel&limit=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```

## Routing

Use `https://api.maton.ai/` with the app-prefixed routes documented in the examples below or in the matching reference file.

**Usage protocol:**
1. Only invoke after the user specifies the exact app, account, and task.
2. Always start with read-only (GET) calls to verify the target account, resource identifiers, and current state.
3. **All non-GET requests are denied unless the user explicitly approves each one.** Before any POST, PUT, PATCH, or DELETE call, present the user with: the exact connection ID, the full endpoint path, the request body, and the expected outcome — then wait for approval.
4. If the user's request implies a non-GET operation, first show them what you intend to call and ask for confirmation. Do not infer approval from the original request.

Read-only route examples:

```text
https://api.maton.ai/slack/api/conversations.list?types=public_channel&limit=10
https://api.maton.ai/google-mail/gmail/v1/users/me/messages
```

The first path segment is the app identifier listed in Supported Services. For Gmail, use `/google-mail/gmail/v1/users/me/messages`.

## Installation

**NPM:**
```bash
npm install -g @maton-ai/cli
```

**Homebrew:**
```bash
brew install maton-ai/cli/maton
```

## Authentication

**IMPORTANT — Credential Safety:**
- Treat `MATON_API_KEY` as a secret. Never log it, echo it, paste it into prompts, or expose it in shared files, command output, or tool results.
- **Connection creation requires explicit user approval.** Before creating any connection, ask the user to confirm the specific service and confirm they intend to authorize access. Never create connections on the agent's own initiative.
- **Least-privilege scopes:** When a service offers scope selection during OAuth, select only the scopes the current task requires. Do not accept broader scopes for convenience.
- Remove connections immediately after the task is complete if they are no longer needed (`maton connection delete {id}`).
- If the key may have been exposed (logs, screenshots, shared terminals), rotate it immediately at [maton.ai/settings](https://maton.ai/settings).
- Never share the key across users, workflows, or environments that do not require it.

**CLI:**

```bash
maton login                          # Opens browser for API key
maton login --interactive            # Skip browser, paste API key directly
maton whoami                         # Show current auth state
```

**Manual:**

1. Sign in or create an account at [maton.ai](https://maton.ai)
2. Go to [maton.ai/settings](https://maton.ai/settings)
3. Click the copy button on the right side of API Key section to copy it
4. Set your API key as `MATON_API_KEY`:

```bash
export MATON_API_KEY="YOUR_API_KEY"
```

## Connection Management

Connection management uses a separate base URL: `https://api.maton.ai`

### List Connections

**CLI:**

```bash
maton connection list slack --status ACTIVE
```

```bash
maton api -X GET /connections -f app=slack -f status=ACTIVE
```

**Python:**

```bash
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections?app=slack&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```

**Query Parameters (optional):**
- `app` - Filter by service name (e.g., `slack`, `hubspot`, `salesforce`)

SKILL.md 不止这些内容,安装后可阅读全文。

技能包内容

共 224 个文件,合计 847.8 KiB

  • SKILL.md49.5 KiB
  • _meta.json132 B
  • references/active-campaign/README.md3.4 KiB
  • references/acuity-scheduling/README.md3.3 KiB
  • references/airtable/README.md3.2 KiB
  • references/apify/README.md3.9 KiB
  • references/apollo/README.md4.3 KiB
  • references/asana/README.md5.0 KiB
  • references/attio/README.md5.1 KiB
  • references/basecamp/README.md3.0 KiB
  • references/baserow/README.md3.9 KiB
  • references/beehiiv/README.md2.8 KiB
  • references/box/README.md5.6 KiB
  • references/brave-search/README.md3.1 KiB
  • references/brevo/README.md4.0 KiB
  • references/buffer/README.md4.6 KiB
  • references/cal-com/README.md3.6 KiB
  • references/calendly/README.md2.9 KiB
  • references/callrail/README.md3.3 KiB
  • references/chargebee/README.md5.7 KiB
  • references/clickfunnels/README.md5.6 KiB
  • references/clicksend/README.md2.6 KiB
  • references/clickup/README.md3.2 KiB
  • references/clio/README.md6.4 KiB
  • references/clockify/README.md4.0 KiB
  • references/coda/README.md3.8 KiB
  • references/cognito-forms/README.md2.7 KiB
  • references/companycam/README.md3.9 KiB
  • references/confluence/README.md4.9 KiB
  • references/constant-contact/README.md9.5 KiB
  • references/dropbox-business/README.md12.1 KiB
  • references/dropbox/README.md6.4 KiB
  • references/elevenlabs/README.md2.0 KiB
  • references/eventbrite/README.md4.4 KiB
  • references/exa/README.md4.3 KiB
  • references/facebook-page/README.md4.2 KiB
  • references/fal-ai/README.md2.9 KiB
  • references/fathom/README.md2.2 KiB
  • references/firebase/README.md3.3 KiB
  • references/firecrawl/README.md3.7 KiB
  • references/fireflies/README.md2.1 KiB
  • references/front/README.md4.2 KiB
  • references/getresponse/README.md3.0 KiB
  • references/github/README.md9.2 KiB
  • references/google-ads/README.md5.7 KiB
  • references/google-analytics-admin/README.md6.0 KiB
  • references/google-analytics-data/README.md4.4 KiB
  • references/google-apps-script/README.md3.5 KiB
  • references/google-bigquery/README.md4.4 KiB
  • references/google-calendar/README.md5.4 KiB
  • references/google-classroom/README.md2.9 KiB
  • references/google-contacts/README.md3.5 KiB
  • references/google-docs/README.md3.6 KiB
  • references/google-drive/README.md7.9 KiB
  • references/google-forms/README.md4.4 KiB
  • references/google-mail/README.md5.8 KiB
  • references/google-meet/README.md3.0 KiB
  • references/google-merchant/README.md5.3 KiB
  • references/google-play/README.md4.0 KiB
  • references/google-search-console/README.md4.1 KiB
  • references/google-sheets/README.md7.4 KiB
  • references/google-slides/README.md4.8 KiB
  • references/google-tag-manager/README.md3.6 KiB
  • references/google-tasks/README.md4.9 KiB
  • references/google-workspace-admin/README.md4.9 KiB
  • references/grafana/README.md3.0 KiB
  • references/granola-mcp/README.md5.9 KiB
  • references/granola-mcp/schemas/get_meeting_transcript.json819 B
  • references/granola-mcp/schemas/get_meetings.json893 B
  • references/granola-mcp/schemas/list_meetings.json1.5 KiB
  • references/granola-mcp/schemas/query_granola_meetings.json1.6 KiB
  • references/gumroad/README.md3.6 KiB
  • references/highlevel-pit/README.md7.3 KiB
  • references/hubspot/README.md12.7 KiB
  • references/instantly/README.md3.2 KiB
  • references/jira/README.md6.2 KiB
  • references/jobber/README.md3.9 KiB
  • references/jotform/README.md3.9 KiB
  • references/kaggle/README.md2.8 KiB
  • references/keap/README.md3.3 KiB
  • references/kibana/README.md2.9 KiB
  • references/kit/README.md3.6 KiB
  • references/klaviyo/README.md5.2 KiB
  • references/lemlist/README.md2.7 KiB
  • references/linear/README.md5.7 KiB
  • references/linkedin-community-management/README.md5.4 KiB
  • references/linkedin/README.md10.1 KiB
  • references/mailchimp/README.md4.4 KiB
  • references/mailerlite/README.md4.3 KiB
  • references/mailgun/README.md5.0 KiB
  • references/make/README.md3.7 KiB
  • references/manus/README.md2.6 KiB
  • references/manychat/README.md3.9 KiB
  • references/memelord/README.md1.9 KiB
  • references/microsoft-excel/README.md4.1 KiB
  • references/microsoft-teams/README.md6.1 KiB
  • references/microsoft-to-do/README.md3.9 KiB
  • references/monday/README.md4.7 KiB
  • references/motion/README.md2.9 KiB
  • references/netlify/README.md3.9 KiB
  • references/notion-mcp/README.md13.1 KiB
  • references/notion-mcp/schemas/notion-create-comment.json17.6 KiB
  • references/notion-mcp/schemas/notion-create-database.json3.4 KiB
  • references/notion-mcp/schemas/notion-create-pages.json8.7 KiB
  • references/notion-mcp/schemas/notion-duplicate-page.json927 B
  • references/notion-mcp/schemas/notion-fetch.json2.1 KiB
  • references/notion-mcp/schemas/notion-get-comments.json1.6 KiB
  • references/notion-mcp/schemas/notion-get-teams.json863 B
  • references/notion-mcp/schemas/notion-get-users.json1.7 KiB
  • references/notion-mcp/schemas/notion-move-pages.json3.3 KiB
  • references/notion-mcp/schemas/notion-search.json4.3 KiB
  • references/notion-mcp/schemas/notion-update-data-source.json3.7 KiB
  • references/notion-mcp/schemas/notion-update-page.json8.4 KiB
  • references/notion/README.md10.2 KiB
  • references/one-drive/README.md4.1 KiB
  • references/one-note/README.md3.1 KiB
  • references/outlook/README.md7.5 KiB
  • references/pdf-co/README.md5.2 KiB
  • references/pipedrive/README.md3.3 KiB
  • references/podio/README.md3.5 KiB
  • references/posthog/README.md3.5 KiB
  • references/quickbooks/README.md11.4 KiB
  • references/quo/README.md3.2 KiB
  • references/reducto/README.md2.7 KiB
  • references/resend/README.md6.3 KiB
  • references/salesforce/README.md9.1 KiB
  • references/sendgrid/README.md3.1 KiB
  • references/sentry/README.md3.3 KiB
  • references/sharepoint/README.md5.5 KiB
  • references/signnow/README.md2.1 KiB
  • references/slack/README.md12.0 KiB
  • references/snapchat/README.md3.0 KiB
  • references/squarespace/README.md8.4 KiB
  • references/squareup/README.md10.1 KiB
  • references/stripe/README.md9.8 KiB
  • references/sunsama-mcp/README.md4.6 KiB
  • references/sunsama-mcp/schemas/accept_meeting_invite.json299 B
  • references/sunsama-mcp/schemas/add_subtasks_to_task.json663 B
  • references/sunsama-mcp/schemas/add_task_to_channel.json386 B
  • references/sunsama-mcp/schemas/align_task_with_objective.json414 B
  • references/sunsama-mcp/schemas/append_task_notes.json379 B
  • references/sunsama-mcp/schemas/change_backlog_folder.json399 B
  • references/sunsama-mcp/schemas/create_braindump_task.json616 B
  • references/sunsama-mcp/schemas/create_calendar_event.json421 B
  • references/sunsama-mcp/schemas/create_channel.json301 B
  • references/sunsama-mcp/schemas/create_follow_up_task_from_email.json575 B
  • references/sunsama-mcp/schemas/create_task.json580 B
  • references/sunsama-mcp/schemas/create_weekly_objective.json440 B
  • references/sunsama-mcp/schemas/decline_meeting_invite.json301 B
  • references/sunsama-mcp/schemas/delete_all_incomplete_recurring_task_instances.json337 B
  • references/sunsama-mcp/schemas/delete_calendar_event.json290 B
  • references/sunsama-mcp/schemas/delete_email_thread.json674 B
  • references/sunsama-mcp/schemas/delete_task.json268 B
  • references/sunsama-mcp/schemas/edit_subtask_title.json526 B
  • references/sunsama-mcp/schemas/edit_task_recurrence_rule.json448 B
  • references/sunsama-mcp/schemas/edit_task_time_estimate.json418 B
  • references/sunsama-mcp/schemas/edit_task_title.json375 B
  • references/sunsama-mcp/schemas/get_archived_tasks.json162 B
  • references/sunsama-mcp/schemas/get_backlog_tasks.json171 B
  • references/sunsama-mcp/schemas/get_task_time_estimate.json309 B
  • references/sunsama-mcp/schemas/import_task_from_calendar_event.json312 B
  • references/sunsama-mcp/schemas/list_email_threads.json310 B
  • references/sunsama-mcp/schemas/log_user_feedback.json277 B
  • references/sunsama-mcp/schemas/mark_email_thread_as_read.json552 B
  • references/sunsama-mcp/schemas/mark_subtask_as_completed.json409 B
  • references/sunsama-mcp/schemas/mark_subtask_as_incomplete.json411 B
  • references/sunsama-mcp/schemas/mark_task_as_completed.json441 B
  • references/sunsama-mcp/schemas/mark_task_as_incomplete.json282 B
  • references/sunsama-mcp/schemas/move_calendar_event.json536 B
  • references/sunsama-mcp/schemas/move_task_from_backlog.json432 B
  • references/sunsama-mcp/schemas/move_task_to_backlog.json288 B
  • references/sunsama-mcp/schemas/move_task_to_day.json428 B
  • references/sunsama-mcp/schemas/reorder_tasks.json484 B
  • references/sunsama-mcp/schemas/reposition_task_in_backlog.json622 B
  • references/sunsama-mcp/schemas/restore_task.json279 B
  • references/sunsama-mcp/schemas/schedule_next_call.json569 B
  • references/sunsama-mcp/schemas/search_tasks.json292 B
  • references/sunsama-mcp/schemas/set_calendar_event_allow_task_projections.json518 B
  • references/sunsama-mcp/schemas/set_shutdown_time.json508 B
  • references/sunsama-mcp/schemas/start_task_timer.json276 B
  • references/sunsama-mcp/schemas/stop_task_timer.json274 B
  • references/sunsama-mcp/schemas/timebox_a_task_to_calendar.json555 B
  • references/sunsama-mcp/schemas/toggle_auto_import_events.json311 B
  • references/sunsama-mcp/schemas/unarchive_task.json453 B
  • references/sunsama-mcp/schemas/update_all_incomplete_recurring_task_instances.json337 B
  • references/sunsama-mcp/schemas/update_calendar_preferences.json319 B
  • references/sunsama-mcp/schemas/update_import_event_filters.json387 B
  • references/supabase/README.md3.8 KiB
  • references/systeme/README.md3.7 KiB
  • references/tally/README.md3.3 KiB
  • references/tavily/README.md3.0 KiB
  • references/telegram/README.md3.6 KiB
  • references/ticktick/README.md2.7 KiB
  • references/todoist/README.md2.9 KiB
  • references/toggl-track/README.md4.0 KiB
  • references/trello/README.md5.4 KiB
  • references/twenty/README.md3.3 KiB
  • references/twilio/README.md3.9 KiB
  • references/typeform/README.md5.2 KiB
  • references/unbounce/README.md3.1 KiB

另有 24 个文件未列出

来源与审核

审核状态
尚未审核,内容来自上游来源
许可证
未说明

审核状态是平台对上架信息的记录,不构成对上游服务质量或可用性的担保。