技能版本 1.0.0
API Gateway
通过 Maton 管理的 API 路由连接外部服务;仅在用户指定目标应用、账户和任务后使用;以读取/列...
价格
免费
- 安装:免费
在组织开通时一次性收取;再次读取清单或下载不重复收费。
以上为公开标价。你的组织可能有协议价,以控制台显示的价格为准。
如何使用
为组织安装
开通即安装:组织固定使用开通时的版本(当前为 1.0.0)。升级到新版本需要取消后重新开通。
创建凭证
客户端使用组织凭证读取;绑定到数字人后,数字人使用绑定凭证按需加载。请求中携带:
Authorization: Bearer $ZGI_MARKET_KEY读取清单与安装包
清单列出版本、文件和校验值;安装包是一个 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 个文件未列出
来源与审核
- 审核状态
- 尚未审核,内容来自上游来源
- 许可证
- 未说明
审核状态是平台对上架信息的记录,不构成对上游服务质量或可用性的担保。