உள்ளடக்கத்துக்குச் செல்
KeuralDocs
டெவலப்பர்கள்

செருகுநிரல்·MCP சேவையக ஒருங்கிணைப்பு

நீங்களே உருவாக்கிய MCP சேவையகத்தை Keural உடன் இணைப்பது மற்றும் டெஸ்க்டாப் செயலிக்கான செருகுநிரல் தொகுப்பை உருவாக்குவது எப்படி என்பதற்கான விளக்கம்.

Keural இல் உள்ள செருகுநிரல்கள் MCP (Model Context Protocol) சேவையகங்கள். MCP சேவையகத்தை Keural உடன் இணைப்பதற்கும், டெஸ்க்டாப் செயலிக்கான செருகுநிரல் தொகுப்பை உருவாக்குவதற்குமான விவரக்குறிப்பு இது.

போக்குவரத்து முறை

தளம்போக்குவரத்து முறைபயன்பாடு
வலை·மொபைல்HTTP(Streamable HTTP) · SSEஇணையத்திலிருந்து அணுகக்கூடிய தொலைநிலை MCP சேவையகம்
டெஸ்க்டாப் செயலிSTDIO · HTTPஇந்தக் கணினியில் இயங்கும் சேவையகம், நிறுவனத்தின் உள் நெட்வொர்க் HTTP சேவையகம்
  • வலை உரையாடல்கள் தொலைநிலை HTTP·SSE சேவையகங்களை மட்டுமே பயன்படுத்தும். STDIO சேவையகங்கள் டெஸ்க்டாப் செயலியில் இயங்கும்.
  • சேவையக முகவரி /mcp இல் முடிந்தால் அது பொதுவாக Streamable HTTP சேவையகம். போக்குவரத்து முறையாக HTTP ஐத் தேர்ந்தெடுக்கவும்.
  • டெஸ்க்டாப்பில் உள்ள HTTP நிறுவனத்தின் உள் நெட்வொர்க் முகவரிகளுக்கானது. பொது இணைய முகவரி வலையில் HTTP ஆகப் பதிவு செய்யப்படும்.

நேரடிச் சேர்த்தல் உள்ளீட்டு மதிப்புகள்

அமைப்புகள் → செருகுநிரல்கள் → + தனிப்பயன் MCP சேர் இல் உள்ள உள்ளீட்டுப் புலங்கள் பின்வருமாறு.

புலம்உள்ளடக்கம்
பெயர்கட்டாயம்
விளக்கம்விருப்பத்தேர்வு
போக்குவரத்து முறைமேலுள்ள அட்டவணையைப் பார்க்கவும்
வகைபட்டியலில் வகைப்படுத்தல்
சேவையக URLHTTP·SSE எனில் கட்டாயம். எ.கா: https://example.com/mcp
இயக்கக் கட்டளைSTDIO எனில் கட்டாயம். எ.கா: npx
வாதங்கள்STDIO வாதங்கள் (JSON வரிசை). எ.கா: ["-y", "@scope/server"]
வலைத் தேடலுக்கு இந்தச் செருகுநிரலைப் பயன்படுத்துஇயக்கினால், வலைத் தேடலுக்குப் பதிலாக இந்தச் செருகுநிரல் பயன்படுத்தப்படும்.
அங்கீகாரம்அங்கீகாரம் இல்லை · API விசை
தலைப்புப் பெயர் · API விசை மதிப்புAPI விசையாக இருக்கும்போது. எ.கா: தலைப்புப் பெயர் Authorization, மதிப்பு Bearer …

API விசையைத் தேர்ந்தெடுத்தால், ஒவ்வொரு கோரிக்கைக்கும் <தலைப்புப் பெயர்>: <மதிப்பு> தலைப்பைச் சேர்த்து அனுப்பும்.

OAuth அங்கீகார சேவையகங்கள்

நிறுவன நிர்வாகி OAuth முறையில் பதிவு செய்த செருகுநிரல்களை, பயனர் இணை என்பதை அழுத்தி உள்நுழைவார்.

உருப்படிமதிப்பு
சேவையகக் கண்டுபிடிப்பு/.well-known/oauth-protected-resource (பாதையுடன் → மூலம்), பின்னர் /.well-known/oauth-authorization-server
கிளையன்ட் பதிவுடைனமிக் கிளையன்ட் பதிவு (DCR)
திசைதிருப்பல் URIhttps://api.keural.ai/api/user-connectors/oauth/callback
கோரிக்கைத் தலைப்புAuthorization: Bearer <access token>

உள்நுழைவுச் சாளரம் பாப்-அப்பாகத் திறக்கும். முடிந்ததும் செருகுநிரல் பட்டியல் புதுப்பிக்கப்படும்.

கருவி அனுமதிகள்

ஒவ்வொரு செருகுநிரல் கருவியும் எவ்வாறு இயங்கும் என்பதைத் தீர்மானிக்கவும்.

அனுமதிசெயல்பாடு
எப்போதும் அனுமதிஉறுதிப்படுத்தாமல் இயக்கும்.
ஒவ்வொரு முறையும் கேள்இயக்குவதற்கு முன் ஒப்புதல் அட்டை காட்டப்படும். அட்டையில் கருவியின் வாதங்களும் காட்டப்படும்.
தடுக்கப்பட்டதுமுகவர் இந்தக் கருவியைப் பயன்படுத்தாது.

டெஸ்க்டாப் செருகுநிரல் தொகுப்பு

டெஸ்க்டாப் செயலி செருகுநிரல் ZIP கோப்பு… அல்லது செருகுநிரல் கோப்புறை… மூலம் செருகுநிரலை நிறுவும். தொகுப்பில் plugin.json மேனிஃபெஸ்ட் கோப்பு இருக்க வேண்டும்.

{
  "id": "my-plugin",
  "name": "My Plugin",
  "version": "1.0.0",
  "description": "நிறுவன அமைப்பு தேடல்",
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["server.js"],
      "env": { "API_BASE": "https://intranet.example.com" }
    }
  }
}
புலம்கட்டாயம்உள்ளடக்கம்
idஆம்ஆங்கிலச் சிற்றெழுத்து, எண்கள், கோடு (-)
nameஇல்லைகாட்சிப் பெயர். இல்லையெனில் id பயன்படுத்தப்படும்.
versionஇல்லைஇயல்பு 1.0.0
descriptionஇல்லைவிளக்கம்
minAppVersionஇல்லைதேவையான குறைந்தபட்ச செயலி பதிப்பு
mcpServersஇல்லைMCP சேவையக வரையறைகள். ஒவ்வொன்றுக்கும் command, args, env
requestsஇல்லைகோரும் அனுமதிகள் (capabilities, commands, connectors, secrets, permissions). சர வரிசை

வலையில் பதிவு செய்த STDIO செருகுநிரல், டெஸ்க்டாப் செயலியில் இந்தக் கணினியில் நிறுவு மூலம் நிறுவப்படும். நிறுவிய பின் அங்கீகார டோக்கனையும் சூழல் மாறிகளையும் நீங்களே உள்ளிட வேண்டும்.

இந்தப் பக்கத்தில்