Dvinaకు సొంత MCP సర్వర్ ఉంది. Claude Code, ChatGPT లేదా Cursor వంటి MCP క్లయింట్‌ను కనెక్ట్ చేస్తే, ఆ యాప్ మీ తరఫున మీ Dvinaలో వెతకగలదు, మీ పత్రాలను, మెమరీని చదవగలదు, నోట్‌లు, టాస్క్‌లు, రిమైండర్‌లను జోడించగలదు.
ప్రారంభించే ముందు
మీకు సర్వర్ చిరునామా అవసరం:
https://api.dvina.ai/mcp
మీ సంస్థ తన సొంత సర్వర్‌లలో Dvinaను నడుపుతుంటే, మీ సంస్థ Dvina API చిరునామా చివర /mcp చేర్చి ఉపయోగించండి. ఆ చిరునామా కోసం మీ అడ్మిన్‌ను అడగండి.
సర్వర్ Streamable HTTPని ఉపయోగిస్తుంది. క్లయింట్ ట్రాన్స్‌పోర్ట్‌ను ఎంచుకోమని అడిగితే, HTTPని ఎంచుకోండి.
క్లయింట్‌ను కనెక్ట్ చేయండి
Claude Code
మీ టెర్మినల్‌లో దీన్ని అమలు చేయండి:
claude mcp add --transport http dvina https://api.dvina.ai/mcpClaude Codeను ప్రారంభించి,
/mcpను అమలు చేసి, dvinaను ఎంచుకుని, Dvinaకు సైన్ ఇన్ చేయండి.
ChatGPT
- Open the place where ChatGPT lets you add an MCP server.
- Enter
https://api.dvina.ai/mcpas the server's address, and choose OAuth if it asks how to sign in. - Sign in to Dvina when ChatGPT asks.
Cursor
- Open the place where Cursor lets you add an MCP server.
- Add a server named
dvinawith the addresshttps://api.dvina.ai/mcp. - Sign in to Dvina when Cursor asks.
మీకు క్లయింట్ ID లేదా సీక్రెట్ అవసరం లేదు. మొదటిసారి కనెక్ట్ అయినప్పుడు క్లయింట్ Dvinaలో స్వయంగా నమోదు చేసుకుంటుంది.
సైన్ ఇన్ చేయండి
Dvina MCP సర్వర్ మీ బ్రౌజర్‌లో OAuth ద్వారా మిమ్మల్ని సైన్ ఇన్ చేస్తుంది:
- మీరు సాధారణంగా చేసే విధంగానే Dvinaకు సైన్ ఇన్ చేయండి.
- మీరు ఒకటి కంటే ఎక్కువ వర్క్‌స్పేస్‌లలో సభ్యులైతే, వర్క్‌స్పేస్‌ను ఎంచుకోండి కింద ఒకదాన్ని ఎంచుకుని, కొనసాగించండిను ఎంచుకోండి. క్లయింట్ ఆ వర్క్‌స్పేస్‌లో మాత్రమే పనిచేస్తుంది.
- యాక్సెస్‌కు అనుమతి ఇవ్వండి కింద యాప్ పేరును తనిఖీ చేసి, యాక్సెస్‌ను అనుమతించండిను ఎంచుకోండి. ఆ యాప్ మీకు తెలియకపోతే, నిరాకరించండిను ఎంచుకోండి.
క్లయింట్ కనెక్ట్ అయి ఉంటుంది, కాబట్టి మీరు ప్రతిసారీ సైన్ ఇన్ చేయాల్సిన అవసరం లేదు.
క్లయింట్ ఏమి చేయగలదు
క్లయింట్‌కు Dvina టూల్స్ కనిపిస్తాయి. మీ అభ్యర్థనకు అవసరమైనప్పుడు వాటిని ఉపయోగిస్తుంది:
| విభాగం | క్లయింట్ చేయగల పనులు |
|---|---|
| శోధన | మీ చాట్‌లు, డాక్యుమెంట్‌లు, మెమరీ, ప్రపంచం అన్నింటిలో ఒకేసారి వెతకవచ్చు. |
| మెమరీ | మీ మెమరీ ఫైళ్ల జాబితాను చూడవచ్చు, వాటిని చదవవచ్చు, కొత్త ఫైల్‌ను జోడించవచ్చు లేదా ఉన్న ఫైల్‌ను మార్చవచ్చు. |
| ప్రపంచం | మీ అంశాల జాబితాను చూడవచ్చు, ఒక అంశం గురించి లేదా మరేదైనా విషయం గురించి Dvinaకు తెలిసినది చూడవచ్చు, మీ ఫీడ్ జాబితాను చూడవచ్చు. |
| డాక్యుమెంట్‌లు | మీ లైబ్రరీలోని వాటి జాబితాను చూడవచ్చు, వాటిని చదవవచ్చు, వెతకవచ్చు, నోట్‌లు, ఫోల్డర్‌లు సృష్టించవచ్చు, ఫైళ్లను అప్‌లోడ్ చేయవచ్చు, డాక్యుమెంట్‌ను భర్తీ చేయవచ్చు, తరలించవచ్చు, పేరు మార్చవచ్చు లేదా ట్రాష్‌కు తరలించవచ్చు. |
| కాన్వాస్ | మీ కాన్వాస్‌ల జాబితాను చూడవచ్చు, వాటిని చదవవచ్చు, కాన్వాస్‌ను సృష్టించవచ్చు లేదా పేజీని తిరిగి రాయవచ్చు. |
| పనులు, లక్ష్యాలు | మీ పనుల జాబితాను చూడవచ్చు, అవి ఏమి చేశాయో చదవవచ్చు, పనిని లేదా లక్ష్యం వైపు పనిచేసే పనిని ప్రారంభించవచ్చు, ఒక పనికి మరింత చేయాల్సినది పంపవచ్చు లేదా పనిని ఆపవచ్చు. |
| షెడ్యూల్ చేసిన సందేశాలు | వాటి జాబితాను చూడవచ్చు, ఒకసారి లేదా పదేపదే పంపేలా సందేశాన్ని లేదా రిమైండర్‌ను షెడ్యూల్ చేయవచ్చు లేదా రద్దు చేయవచ్చు. |
| ఏజెంట్లు, నైపుణ్యాలు | మీ ఏజెంట్లు, నైపుణ్యాల జాబితాను చూడవచ్చు, వాటిని చదవవచ్చు, ఏజెంట్‌ను సృష్టించవచ్చు, నైపుణ్యాన్ని జోడించవచ్చు లేదా వాటిలో దేనినైనా మార్చవచ్చు. |
| ప్రాజెక్ట్‌లు | మీ ప్రాజెక్ట్‌ల జాబితాను చూడవచ్చు, ప్రాజెక్ట్ ఫోల్డర్‌ను, ఇటీవలి పనులను చూడవచ్చు. |
| షేరింగ్ | ఒక అంశానికి ఎవరికి యాక్సెస్ ఉందో, ఇతరులు మీతో ఏమి పంచుకున్నారో చూడవచ్చు లేదా ఎవరికైనా యాక్సెస్ ఇవ్వవచ్చు, తొలగించవచ్చు. |
| సెట్టింగ్‌లు | మీ ప్రాధాన్యతలను చూడవచ్చు లేదా మెమరీని ఆన్ లేదా ఆఫ్ చేయవచ్చు. |
క్లయింట్ దేన్నీ శాశ్వతంగా తొలగించలేదు, పబ్లిక్ లింక్‌లను తెరవలేదు, యాప్‌లను కనెక్ట్ చేయలేదు లేదా డిస్‌కనెక్ట్ చేయలేదు, అడ్మిన్ లేదా బిల్లింగ్ సెట్టింగ్‌లను మార్చలేదు.
మార్పులను ఆమోదించండి
క్లయింట్ చేసే పనులకూ Dvinaలో మిగతా చోట్ల వర్తించే నియమాలే వర్తిస్తాయి:
- చదవడానికి మీ అనుమతి అడగదు.
- నోట్, మెమరీ ఫైల్ లేదా పని వంటి కొత్తదాన్ని జోడించడానికి మీ అనుమతి అడగదు. ఇప్పటికే ఉన్నదాన్ని అది ఎప్పుడూ మార్చదు.
- డాక్యుమెంట్‌ను ట్రాష్‌కు తరలించడం, కాన్వాస్ పేజీని తిరిగి రాయడం, పనిని ఆపడం లేదా అంశాన్ని పంచుకోవడం వంటి మార్పులు చేయడానికి లేదా తొలగించడానికి ముందుగా మిమ్మల్ని అడుగుతుంది. ఆ మార్పు గురించి Dvina ఇచ్చే సారాంశాన్నే క్లయింట్ చూపిస్తుంది. మీరు దాన్ని ఆమోదించవచ్చు లేదా తిరస్కరించవచ్చు. మీరు తిరస్కరిస్తే ఏదీ మారదు.
గమనిక
క్లయింట్ మీ నిర్ధారణను అడగలేకపోతే, దాని ద్వారా Dvina ఆ మార్పు చేయదు. బదులుగా Dvina యాప్‌లో మార్పు చేయండి లేదా మీ నిర్ధారణను అడగగల క్లయింట్‌ను ఉపయోగించండి.
మీ యాక్సెస్, మీ కంపెనీ నియమాలు
Dvinaలో మీరు చూడగలిగేవి, చేయగలిగేవి మాత్రమే ఉపయోగిస్తూ క్లయింట్ మీ తరఫున పనిచేస్తుంది:
- మీరు వర్క్‌స్పేస్‌లో సభ్యులుగా ఉన్నంతవరకే, మీ పాత్ర అనుమతించే వాటితో మాత్రమే ఇది పనిచేస్తుంది.
- ఫైల్ అప్‌లోడ్‌ల వంటి ఫీచర్‌ను మీ అడ్మిన్ ఆఫ్ చేస్తే, క్లయింట్ కూడా దాన్ని ఉపయోగించలేదు.
- యాప్‌లో మాదిరిగానే, క్లయింట్ జోడించే లేదా మార్చే వాటికి మీ కంపెనీ డేటా రక్షణ నియమాలు వర్తిస్తాయి.
- అది జోడించే లేదా మార్చే వాటిని మీ తరఫున అసిస్టెంట్ చేసినవిగా మీ ఆడిట్ లాగ్లో నమోదు చేస్తారు. అవి ఏ క్లయింట్ నుంచి వచ్చాయో కూడా నమోదవుతుంది.
- అది చేసే పనులు మీ సాధారణ పరిమితుల్లోనే మీ వినియోగంలో భాగంగా లెక్కించబడతాయి.
OAuth బదులుగా API కీతో కనెక్ట్ చేయండి
Enterprise ప్లాన్‌లో, క్లయింట్ సైన్ ఇన్ చేయడానికి బదులుగా వ్యక్తిగత యాక్సెస్ టోకెన్‌తో కనెక్ట్ కావచ్చు. OAuthతో సైన్ ఇన్ చేయలేని క్లయింట్ కోసం లేదా స్క్రిప్ట్ కోసం దీన్ని ఉపయోగించండి.
- సెట్టింగ్‌లను తెరిచి API యాక్సెస్ ఎంచుకోండి.
- వ్యక్తిగత యాక్సెస్ టోకెన్‌లు కింద టోకెన్ సృష్టించండి ఎంచుకోండి.
- పేరు నమోదు చేసి, యాక్సెస్, గడువు ముగిసే సమయం ఎంచుకోండి. ఆ తర్వాత టోకెన్ సృష్టించండి ఎంచుకోండి.
- మీ టోకెన్‌ను కాపీ చేయండి కింద టోకెన్‌ను కాపీ చేయండి. ఇది ఈ ఒక్కసారే కనిపిస్తుంది.
క్లయింట్‌కు అవసరమైన యాక్సెస్‌ను ఎంచుకోండి:
- చదవడానికి మాత్రమే: క్లయింట్‌కు చదివే సాధనాలు మాత్రమే కనిపిస్తాయి. ఇది మీ Dvinaలో వెతకగలదు, చదవగలదు, కానీ దేన్నీ జోడించలేదు లేదా మార్చలేదు.
- చదవడానికి, రాయడానికి: క్లయింట్‌కు అన్ని సాధనాలు కనిపిస్తాయి. OAuthలో మాదిరిగానే, మార్పులకు ఇప్పటికీ మీ ఆమోదం అడుగుతుంది.
Authorization హెడర్‌లో Bearer తర్వాత టోకెన్‌ను పంపండి. ఉదాహరణకు, Claude Codeలో:
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
మరో క్లయింట్‌లో, MCP సర్వర్ కోసం హెడర్‌లను సెట్ చేసే చోట ఇదే హెడర్‌ను జోడించండి.
మీరు టోకెన్‌ను సృష్టించిన వర్క్‌స్పేస్‌లో, అక్కడ మీకు ప్రస్తుతం ఉన్న పాత్రతో అది మీ తరఫున పనిచేస్తుంది. దాన్ని భర్తీ చేయడానికి, వ్యక్తిగత యాక్సెస్ టోకెన్‌లు కింద దాన్ని తెరిచి మార్చండి… ఎంచుకోండి: దాని స్థానంలో కొత్త టోకెన్ వస్తుంది, పాతది వెంటనే పనిచేయడం ఆగిపోతుంది. దాన్ని నిలిపివేయడానికి, రద్దు చేయండి… ఎంచుకోండి: దాన్ని ఉపయోగించే ఏదైనా వెంటనే పనిచేయడం ఆగిపోతుంది.
టోకెన్‌ల గురించి మరింత తెలుసుకోవడానికి, API యాక్సెస్ చూడండి.