Kodsuz integrasiýalar — AiHummer Resminamalar

Tier-3 pluginleri kodsuz: bar bolan hyzmaty hiç hili integrasiýa kody ýazman ýa-da ýerleşdirmän agentlere elýeterli edýärsiňiz. Iki çeşme görnüşi bar — OpenAPI we MCP — we ikisi-de gizlin maglumatlaryny aç-açan sazlamadan däl-de, şifrlenen gapjykdan çözýär.

OpenAPI: her operasiýa üçin bir gural

AiHummer-i onuň spec_url-i arkaly islendik OpenAPI 3.x speke ugrukdyryň we platforma spekdäki her operasiýa üçin bir gural döredýär. Her operasiýa agentiň funksiýa-çagyryş tertibinde ulanyp biljek çagyrylýan gurala öwrülýär — ýelim kody ýok, her-ahyrky-nokat birikdirmesi ýok.

{
  "slug": "acme-api",
  "name": "Acme API",
  "version": "1.0.0",
  "kind": "openapi",
  "spec_url": "https://api.acme.example/openapi.json"
}

Spekiň securityScheme-i arkaly auth

Autentifikasiýa göni spekden alynýar. AiHummer OpenAPI securityScheme-ni okaýar, we hakyky gizlin maglumat çagyryş wagtynda gapjykdan alynýar — şonuň üçin maglumat hiç haçan manifeste, ündewe ýa-da loglara içine ýazylmaýar.

[!NOTE] Döredilen gurallar spekiň öz operasiýalaryna we howpsuzlygyna eýerýär. OpenAPI resminamaňyzy takyk saklaň: onuň yglan edýän operasiýalary takyk agentiň görjek gurallarydyr.

Taýýar şahsy integrasiýalar (her ulanyjy OAuth)

Şol bir OpenAPI mehanizmi uly toplum taýýar şahsy integrasiýalary goldaýar: her biri adamyň öz hasabyna birikdirýän her-ulanyjy OAuth integrasiýasydyr, soňra gurallar onuň adyndan hereket edýär. Eýýäm elýeterli Gmail, Google Calendar, Google Contacts, Google Tasks, Google Drive, YouTube, Outlook Mail, Outlook Calendar, OneDrive, Microsoft To Do, Todoist, Asana, Jira Cloud, ClickUp, GitLab, Fitbit, Oura Ring, Spotify, Samsung SmartThings we başgalar. Şahsy hasaby birikdirmek her-ulanyjy Birikmeler bölüminde beýan edilýär.

MCP: islendik serweri birikdiriň

Ikinji çeşme görnüşi islendik MCP serwerini birikdirýär. AiHummer onuň bilen stdio ýa-da http transport arkaly gürleşýär, onuň tools/list-ini çagyrýar we gaýdyp gelen gurallary agente açýar. OpenAPI ýaly, bu integrasiýa kody talap etmeýär.

{
  "slug": "acme-mcp",
  "name": "Acme MCP",
  "version": "1.0.0",
  "kind": "mcp",
  "transport": "http",
  "url": "https://mcp.acme.example/"
}

Stdio-transport serweri URL ýerine ony işledýän buýruk bilen sazlanýar:

{
  "slug": "local-mcp",
  "name": "Local MCP",
  "version": "1.0.0",
  "kind": "mcp",
  "transport": "stdio",
  "command": "my-mcp-server"
}

Gapjyk → env arkaly gizlin maglumatlar

MCP serwerleri üçin gizlin maglumatlar serweriň işleýän gurşawyna gapjykdan akýar. Siz gizlin maglumaty gapjyga bir gezek saklaýarsyňyz; AiHummer ony serweri işledende ýa-da oňa birikdirende daşky gurşaw üýtgeýjisi hökmünde girizýär, şonuň üçin gizlin material manifestiň we model kontekstiniň daşynda galýar.

OpenAPI garşy MCP bir bakyşda

	OpenAPI	MCP
Giriş	OpenAPI 3.x `spec_url`	MCP serwer (stdio ýa-da http)
Döredilen gurallar	Spekdäki her operasiýa üçin biri	`tools/list` näme gaýtarsa
Auth	Spekiň `securityScheme`-i → gapjyk	Serwer üçin gapjyk → env
Gerekli kod	Ýok	Ýok

Haýsysyny haçan ulanmaly

Hyzmat eýýäm OpenAPI resminamasyny çap edende OpenAPI-a ýüzleniň — onuň doly operasiýa toplumyny awtomatiki gural hökmünde alýarsyňyz.
Bar bolan MCP serwerini birikdirmek isläniňizde ýa-da ýerli gural serwerini stdio arkaly işletmek isläniňizde MCP-a ýüzleniň.

[!TIP] Iki çeşme görnüşi-de beýleki her plugin ýaly şol bir bir-faýlly manifest.json bilen kesgitlenýär — openapi we mcp görnüşleri we aihummer plugin validate üçin Plugin SDK bölümine serediň.

Indiki ädim

Plugin SDK — openapi we mcp üçin manifest meýdanlary.
Marketplace umumy syn we derejeler — kodsuz (Tier 3) nirede ýerleşýär.
Şahsy garşy paýlaşylan maglumatlar — bu gurallaryň ulanýan gapjyk gizlin maglumatlarynyň nähili çäklendirilýändigi.