API
管ç API â ã€ã³ã¹ã¿ã³ã¹å šäœã®ããã®
ããã·ã¥ããŒããã§ããããšãã¹ãŠã REST ã§ãconnector ã®äœæãããŒã«ã®çæãcode mode ã®åãæ¿ããããŒã®çºè¡ãFile Search ã®å®è¡ â ã¹ã¯ãªãããCI ãžã§ãããšãŒãžã§ã³ãããã
# a management key from the dashboard or `amcp login --browser`$ export AMCP_API_KEY=amk_live_xxx# the CLI resolves the base URL and auth for you$ amcp api GET /api/connectors$ amcp api POST /api/mcp-servers --data '{"name":"ops"}'# or call the HTTP API directly$ curl -H "Authorization: Bearer $AMCP_API_KEY" \ https://cloud.anythingmcp.com/api/connectors
èªèšŒ
2 ã€ã® realm ã API ã«å°éããã©ã¡ããããªãã®ããŒã«ãå°éããŸããåŒã³åºãå ã«åãã»ããéžãã§ãã ããã
ã»ãã·ã§ã³ (JWT)
ããã·ã¥ããŒãã«ãµã€ã³ã€ã³æžã¿ã®ãŠãŒã¶ãŒãèšå®äžèŠ â ãã©ãŠã¶ãã»ãã·ã§ã³ãä¿æããŸãã
管çããŒ
ã¹ã¯ãªããããšãŒãžã§ã³ãåããèšå®ç»é¢ãŸã㯠`amcp login --browser` ã§ scope ä»ãããŒãçºè¡ããBearer token ãšããŠéä¿¡ããŸãã
scope â ããŒã«ã¯ scopeïŒmanagement-read ãŸã㯠management-adminïŒãä»ãããã®å®å¹çãªæš©éã¯ããŒã® scope ãšææè ã®ããŒã«ã®ãã¡å°ããã»ãã«ãªããŸãããšãŒãžã§ã³ãçšããŒã¯æ¢å®ã§ read-only ã§ãã
åŒã³åºãããã®
200 ãè¶ ããæäœããªãœãŒã¹ããšã«ã°ã«ãŒãåãåžžã«ææ°ã®å®å šãªã¹ããŒãã¯ã€ã³ã¿ã©ã¯ãã£ãã»ãªãã¡ã¬ã³ã¹ã§åç §ã§ããŸãã
Connectors
/api/connectorsconnector ãäœæããOpenAPIã»WSDLã»GraphQLã»Postmanã»cURLã»HAR ããããŒã«ãã€ã³ããŒã â ãŸã㯠MCP server ããæ€åºããŸãã
Tools
/api/connectors/:id/toolsconnector ãå ¬éããããŒã«ãããã®å ¥åã¹ããŒããšãšãã«äžèЧã»äœæã»æŽæ°ã»åé€ããŸãã
MCP servers
/api/mcp-serversserver ãäœæããããŒã«ãšããŒã«ãå²ãåœãŠãcode mode ã offã»toolsã»inline ã®éã§åãæ¿ããŸãã
Adapters
/api/adaptersãã䜿ãã connector ã®çµã¿èŸŒã¿ã«ã¿ãã°ãã slug ã§ã€ã³ããŒãããŸãã
API keys
/api/mcp-keysMCP ããã³ management-scoped ã®ããŒãçºè¡ã»äžèЧã»å€±å¹ â self-service ã§ãããªãã®ã¢ã«ãŠã³ãã«çŽã¥ããŸãã
File Search
/api/file-searchæ€çŽ¢å¯èœãª space ãšãã©ã«ãã管çãããšãŒãžã§ã³ããããªãã®ããã¥ã¡ã³ãããååŸã§ããããã«ããŸãã
èŠçŽ
Base URL
Cloud ã§ã¯ cloud.anythingmcp.comãself-hosted ã§ã¯ããªãèªèº«ã®ãã¹ããCLI ã解決ããŸãã
Auth ããããŒ
Authorization: Bearer <key>ãåã guard ãã»ãã·ã§ã³ JWT ãåãä»ããŸãã
ãã©ãŒããã
JSON ãéã£ãŠ JSON ãåãåããbody 㯠--dataïŒCLIïŒãŸã㯠Content-Type: application/jsonïŒHTTPïŒã§éä¿¡ããŸãã
ã¹ã³ãŒã
ãã¹ãŠã®ã¯ãšãªã¯ããªãã®çµç¹ã«éå®ãããããŒãä»ã®ããã³ãã®ããŒã¿ã«å±ãããšã¯ãããŸããã
ã¬ãŒãå¶é
æ¢å®ã§ããŒãããæ¯å 300 ãªã¯ãšã¹ããéçšè ã調æŽå¯èœã429 ã¯é床ãèœãšãåå³ã§ãã
ãšã©ãŒ
æšæºã® HTTP ã¹ããŒã¿ã¹ã³ãŒãã401 ã¯èªèšŒã®èª€ããŸãã¯æ¬ åŠã403 㯠scope ãããŒã«ãäžè¶³ã404 ã¯æªæ€åºã
API ã®äžã«æ§ç¯ãã
ããŒãååŸããã€ã³ã¿ã©ã¯ãã£ãã»ãªãã¡ã¬ã³ã¹ãéããŠãã€ã³ã¹ã¿ã³ã¹ã端ãã端ãŸã§ã¹ã¯ãªããåããŸãããã