# በMCP አማካይነት Dvinaን ከሌሎች መተግበሪያዎች ይጠቀሙ

> እንደ Claude Code፣ ChatGPT ወይም Cursor ያለ የMCP ደንበኛ ከDvina ጋር ያገናኙ፣ ይግቡ፣ እና በእርስዎ ፈቃድ በDvinaዎ ያለውን እንዲያነብ እና ይዘት እንዲጨምር ይፍቀዱለት።

Dvina የራሱ የMCP አገልጋይ አለው። እንደ Claude Code፣ ChatGPT ወይም Cursor ያለ የMCP ደንበኛ ያገናኙ፤ መተግበሪያውም እርስዎን ወክሎ በDvinaዎ ውስጥ መፈለግ፣ ሰነዶችዎን እና ትውስታዎን ማንበብ፣ እንዲሁም ማስታወሻዎችን፣ ተግባሮችን እና ማሳሰቢያዎችን መጨመር ይችላል።

## ከመጀመርዎ በፊት

የአገልጋዩ አድራሻ ያስፈልግዎታል፦

```text
https://api.dvina.ai/mcp
```

ድርጅትዎ Dvinaን በራሱ አገልጋዮች ላይ የሚያስኬድ ከሆነ፣ መጨረሻው ላይ `/mcp` በመጨመር የድርጅትዎን የDvina API አድራሻ ይጠቀሙ። አድራሻውን አስተዳዳሪዎን ይጠይቁ።

አገልጋዩ Streamable HTTP ይጠቀማል። ደንበኛው የመጓጓዣ ዘዴ እንዲመርጡ ከጠየቀ፣ HTTP ይምረጡ።

## ደንበኛ ያገናኙ

::: tabs

=== Claude Code

1. በተርሚናልዎ ውስጥ ይህን ያስኪዱ፦

    ```sh
    claude mcp add --transport http dvina https://api.dvina.ai/mcp
    ```

2. Claude Codeን ይጀምሩ፣ `/mcp`ን ያስኪዱ፣ **dvina**ን ይምረጡ፣ ከዚያ ወደ Dvina ይግቡ።

=== ChatGPT

1. Open the place where ChatGPT lets you add an MCP server.
2. Enter `https://api.dvina.ai/mcp` as the server's address, and choose OAuth if it asks how to sign in.
3. Sign in to Dvina when ChatGPT asks.

=== Cursor

1. Open the place where Cursor lets you add an MCP server.
2. Add a server named `dvina` with the address `https://api.dvina.ai/mcp`.
3. Sign in to Dvina when Cursor asks.

:::

የደንበኛ መለያ ወይም ሚስጥራዊ ቁልፍ አያስፈልግዎትም። ደንበኛው ለመጀመሪያ ጊዜ ሲገናኝ ራሱን በDvina ይመዘግባል።

## ይግቡ

የDvina MCP አገልጋይ OAuthን በመጠቀም በአሳሽዎ ያስገባዎታል፦

1. እንደተለመደው ወደ Dvina ይግቡ።
2. ከአንድ በላይ የሥራ ቦታዎች አባል ከሆኑ፣ በ**የሥራ ቦታ ይምረጡ** ስር አንዱን ይምረጡ፣ ከዚያ **ቀጥል**ን ይምረጡ። ደንበኛው የሚሠራው በዚያ የሥራ ቦታ ብቻ ነው።
3. በ**የመዳረሻ ፈቃድ ይስጡ** ስር የመተግበሪያውን ስም ያረጋግጡ፣ ከዚያ **መዳረሻ ፍቀድ**ን ይምረጡ። የማያውቁት ከሆነ **አትፍቀድ**ን ይምረጡ።

ደንበኛው ግንኙነቱን እንደያዘ ይቆያል፣ ስለዚህ በእያንዳንዱ ጊዜ እንደገና መግባት አያስፈልግዎትም።

## ደንበኛው ምን ማድረግ ይችላል

ደንበኛው የDvina መሣሪያዎችን ያያል፣ ጥያቄዎም እነሱን መጠቀም ሲጠይቅ ይጠቀምባቸዋል፦

| ክፍል                   | የደንበኛው ፕሮግራም ምን ማድረግ ይችላል                                                                                                                       |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **ፍለጋ**             | ቻቶችዎን፣ ሰነዶችዎን፣ ማህደረ ትውስታዎን እና ዓለምዎን በአንድ ጊዜ መፈለግ።                                                                                      |
| **ማህደረ ትውስታ**             | የማህደረ ትውስታ ፋይሎችዎን መዘርዘር እና ማንበብ፣ አዲስ ፋይል ማከል ወይም ያለውን መቀየር።                                                                               |
| **ዓለም**              | ርዕሶችዎን መዘርዘር፣ Dvina ስለ አንድ ርዕስ ወይም ስለ ሌላ ማንኛውም ነገር የሚያውቀውን ማሳየት እና በዜና ፍሰትዎ ውስጥ ያሉትን መዘርዘር።                                                  |
| **ሰነዶች**          | በቤተ መጻሕፍትዎ ያሉትን መዘርዘር፣ ማንበብ እና መፈለግ፣ ማስታወሻዎችን እና አቃፊዎችን መፍጠር፣ ፋይሎችን መስቀል፣ እንዲሁም ሰነድን መተካት፣ ማንቀሳቀስ፣ እንደገና መሰየም ወይም ወደ ቆሻሻ መጣያ ማዛወር። |
| **ካንቫስ**             | ካንቫሶችዎን መዘርዘር እና ማንበብ፣ ካንቫስ መፍጠር ወይም አንድ ገጽ እንደገና መጻፍ።                                                                             |
| **ተግባራት እና ግቦች**    | ተግባራትዎን መዘርዘር እና ያከናወኑትን ማንበብ፣ ተግባር ወይም ግብ ለማሳካት የሚሠራ ተግባር መጀመር፣ ለተግባር ተጨማሪ ሥራ መላክ ወይም ተግባርን ማቆም።                |
| **ጊዜ የተያዘላቸው መልዕክቶች** | መዘርዘር፣ ለአንድ ጊዜ ወይም ተደጋጋሚ መልዕክት ወይም ማስታወሻ ጊዜ መያዝ፣ ወይም መሰረዝ።                                                                 |
| **ወኪሎች እና ክህሎቶች**  | ወኪሎችዎን እና ክህሎቶችዎን መዘርዘር እና ማንበብ፣ ወኪል መፍጠር፣ ክህሎት ማከል ወይም ከሁለቱ አንዱን መቀየር።                                                        |
| **ፕሮጀክቶች**           | ፕሮጀክቶችዎን መዘርዘር እና የአንድ ፕሮጀክት አቃፊ እና የቅርብ ጊዜ ተግባራትን ማሳየት።                                                                             |
| **ማጋራት**            | አንድን ንጥል ማን መድረስ እንደሚችል እና ሌሎች ምን እንዳጋሩዎት ማየት፣ ወይም ለአንድ ሰው የመዳረሻ ፈቃድ መስጠት ወይም መንሳት።                                           |
| **ቅንብሮች**           | ምርጫዎችዎን ማሳየት፣ ወይም ማህደረ ትውስታን ማብራት ወይም ማጥፋት።                                                                                             |

የደንበኛው ፕሮግራም ማንኛውንም ነገር እስከመጨረሻው መሰረዝ፣ ይፋዊ አገናኞችን መክፈት፣ መተግበሪያዎችን ማገናኘት ወይም ግንኙነታቸውን ማቋረጥ፣ ወይም የአስተዳዳሪ ወይም የክፍያ ቅንብሮችን መቀየር አይችልም።

## ለውጦችን ያጽድቁ

የደንበኛው ፕሮግራም የሚያደርገው ሁሉ በሌሎች የDvina ክፍሎች የሚተገበሩትን ተመሳሳይ ደንቦች ይከተላል፦

- ማንበብ ሳይጠይቅ ይከናወናል።
- እንደ ማስታወሻ፣ የማህደረ ትውስታ ፋይል ወይም ተግባር ያለ አዲስ ነገር ማከል ሳይጠይቅ ይከናወናል። አስቀድሞ ያለውን ነገር ፈጽሞ አይቀይርም።
- አንድን ነገር መቀየር ወይም ማስወገድ፣ ለምሳሌ ሰነድን ወደ ቆሻሻ መጣያ ማዛወር፣ የካንቫስ ገጽ እንደገና መጻፍ፣ ተግባርን ማቆም ወይም ንጥልን ማጋራት፣ መጀመሪያ ፈቃድዎን ይጠይቃል። የደንበኛው ፕሮግራም Dvina ስለ ለውጡ ያዘጋጀውን ማጠቃለያ ያሳይዎታል፣ እርስዎም ያጸድቁታል ወይም እምቢ ይላሉ። እምቢ ካሉ፣ ምንም አይቀየርም።

> [!NOTE]
> የደንበኛ ፕሮግራም ማረጋገጫዎን መጠየቅ ካልቻለ፣ Dvina በዚያ ፕሮግራም በኩል ለውጡን አያደርግም። በምትኩ ለውጡን በDvina መተግበሪያ ውስጥ ያድርጉ፣ ወይም ማረጋገጫ መጠየቅ የሚችል የደንበኛ ፕሮግራም ይጠቀሙ።

## የመዳረሻ ፈቃድዎ እና የኩባንያዎ ደንቦች

የደንበኛው ፕሮግራም እርስዎን ወክሎ፣ በDvina ውስጥ ማየት እና ማድረግ በሚችሉት ወሰን ይሠራል፦

- የሥራ ቦታው አባል እስከሆኑ ድረስ ብቻ፣ እና ሚናዎ በሚፈቅደው ወሰን ብቻ ይሠራል።
- አስተዳዳሪዎ እንደ ፋይል መስቀል ያለ ባህሪ ካጠፋ፣ የደንበኛው ፕሮግራምም ሊጠቀምበት አይችልም።
- የደንበኛው ፕሮግራም የሚያክለው ወይም የሚቀይረው ነገር፣ እንደ መተግበሪያው ሁሉ፣ በኩባንያዎ የውሂብ ጥበቃ ደንቦች ይፈተሻል።
- የሚያክለው ወይም የሚቀይረው ነገር በእርስዎ [የኦዲት መዝገብ](/docs/teams/audit-log) ውስጥ፣ ረዳቱ ለእርስዎ እንዳከናወነው ይመዘገባል፣ የመጣበት የደንበኛ ፕሮግራምም አብሮ ይጠቀሳል።
- የሚያከናውነው ሥራ በመደበኛ ገደቦችዎ ውስጥ ካለው የአጠቃቀም መጠንዎ ይቆጠራል።

## ከOAuth ይልቅ በAPI ቁልፍ ይገናኙ

በEnterprise ዕቅድ ላይ፣ የደንበኛ ፕሮግራም ወደ መለያ ከመግባት ይልቅ በግል መዳረሻ ቶከን ሊገናኝ ይችላል። በOAuth መግባት ለማይችል የደንበኛ ፕሮግራም፣ ወይም ለስክሪፕት፣ ይህን ይጠቀሙ።

1. ቅንብሮችን ይክፈቱ እና **የAPI መዳረሻ**ን ይምረጡ።
2. በ**የግል መዳረሻ ቶከኖች** ስር፣ **ቶከን ፍጠር**ን ይምረጡ።
3. **ስም** ያስገቡ፣ **የመዳረሻ ፈቃድ** እና **የሚያበቃበትን ጊዜ** ይምረጡ፣ ከዚያ **ቶከን ፍጠር**ን ይምረጡ።
4. በ**ቶከንዎን ይቅዱ** ስር፣ ቶከኑን ይቅዱ። ቶከኑ የሚታየው በዚህ ጊዜ ብቻ ነው።

የደንበኛው ፕሮግራም የሚያስፈልገውን የመዳረሻ ፈቃድ ይምረጡ፦

- **ማንበብ ብቻ፦** የደንበኛው ፕሮግራም የሚያየው ለማንበብ የሚያገለግሉትን መሣሪያዎች ብቻ ነው። በእርስዎ Dvina ውስጥ መፈለግ እና ማንበብ ይችላል፣ ግን ምንም ማከል ወይም መቀየር አይችልም።
- **ማንበብ እና መጻፍ፦** የደንበኛው ፕሮግራም ሁሉንም መሣሪያዎች ያያል፣ እና ለውጦች እንደ OAuth ሁሉ አሁንም የእርስዎን ማጽደቅ ይጠይቃሉ።

ቶከኑን በ`Authorization` ራስጌ ውስጥ፣ ከ`Bearer` በኋላ ይላኩ። ለምሳሌ፣ በClaude Code ውስጥ፦

```sh
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
```

በሌላ የደንበኛ ፕሮግራም ውስጥ፣ ለMCP አገልጋይ ራስጌዎችን እንዲያዘጋጁ በሚፈቅድበት ቦታ ይህንኑ ራስጌ ያክሉ።

ቶከኑ እርስዎን ወክሎ፣ በፈጠሩበት የሥራ ቦታ፣ አሁን በዚያ ባለዎት ሚና ይሠራል። እሱን ለመተካት፣ በ**የግል መዳረሻ ቶከኖች** ስር ይክፈቱት እና **አድስ…**ን ይምረጡ፦ አዲስ ቶከን ይተካዋል፣ አሮጌውም ወዲያውኑ መሥራት ያቆማል። እሱን ለማቆም፣ **ሻር…**ን ይምረጡ፦ የሚጠቀምበት ማንኛውም ነገር ወዲያውኑ መሥራት ያቆማል።

ስለ ቶከኖች ተጨማሪ መረጃ ለማግኘት፣ [የAPI መዳረሻ](/docs/dvina-mcp/api-access)ን ይመልከቱ።

## ተዛማጅ

- [ብጁ መተግበሪያዎች እና MCP አገልጋዮች](/docs/connectors/custom-apps)
- [የAPI መዳረሻ](/docs/dvina-mcp/api-access)
- [የdvina ትዕዛዝን ይጠቀሙ](/docs/dvina-mcp/cli)
- [የቡድኖች አጠቃላይ መግለጫ](/docs/teams/overview)