MCP サーバー
AI コーディングエージェントを DEUNA ドキュメントに、モデルコンテキストプロトコルを通じて接続します。
このページで
DEUNA Docsは、リモート Model Context Protocol サーバーに登録し、統合中に検索および読み取ることができます。
エンドポイント#
MCP endpointPlain text
https://docs.deuna.com/api/mcp- 輸送: ストリーム可能な HTTP (
POSTのみ、ステートレス)。 - 認証: なし。 サーバーは、公開されたドキュメントのみを読み取ります。
- ツール:
search_docsドキュメントページを関連度順に並べます。get_docページの Markdown ソースを返します。search_api_reference公開エンドポイントの全インベントリを検索します。get_api_endpoint指定した HTTP メソッドとパスの公開済みコントラクトを返します。また、search_provider_capabilities生成されたプロバイダーカタログを検索します。
上記の URL は、閲覧しているホストに基づいて構築されるため、常にこのページが提供されている環境と一致します。
2 分で接続#
- 上に表示されているエンドポイントをコピーします。
- AI クライアントに、次の名前のリモート Streamable HTTP サーバーとして追加します:
deuna-docs. - クライアントが承認を求めたら、DEUNA ドキュメント用の 5 つの読み取り専用ツールを有効にします。
- 「注文を作成するには？」など、ドキュメントについて質問します。クライアントは回答前に
search_docsまたはsearch_api_referenceを呼び出す必要があります。
DEUNA API key や ATHIA token は不要です。MCP サーバーが公開するのは公開済みのドキュメントコーパスのみで、MCP クライアントから認証情報を受け取ることはありません。
Claude Code#
一度実行します。 --scope user プロジェクトごとに利用できるようにするには、追加します。 --scope project または、 .mcp.json.
TerminalShell
claude mcp add --transport http deuna-docs https://docs.deuna.com/api/mcp実行 claude mcp list を使用してサーバーが接続されていることを確認します。
Claude Desktop および claude.ai#
- 開きます 設定 › コネクタ.
- 選択 カスタムコネクタを追加.
- 名前を付ける
DEUNA DocsおよびURLを貼り付けます：
Remote MCP server URLPlain text
https://docs.deuna.com/api/mcpカーソル#
サーバーを ~/.cursor/mcp.json すべてのプロジェクトに追加するか、 .cursor/mcp.json 単一のリポジトリに追加します。
~/.cursor/mcp.jsonJSON
{
"mcpServers": {
"deuna-docs": {
"url": "https://docs.deuna.com/api/mcp"
}
}
}その後、 設定 › MCP および確認してください deuna-docs を有効にします。
VS Code (GitHub Copilot)#
サーバーを .vscode/mcp.json ワークスペースで接続するか、ターミナルから登録してください。
{
"servers": {
"deuna-docs": {
"type": "http",
"url": "https://docs.deuna.com/api/mcp"
}
}
}code --add-mcp '{"name":"deuna-docs","type":"http","url":"https://docs.deuna.com/api/mcp"}'Copilot Chat のツールを エージェント mode.
Windsurf#
サーバーを ~/.codeium/windsurf/mcp_config.json、その後 Cascade で MCP リストを更新します。
~/.codeium/windsurf/mcp_config.jsonJSON
{
"mcpServers": {
"deuna-docs": {
"serverUrl": "https://docs.deuna.com/api/mcp"
}
}
}Codex CLI#
ターミナルをサーバーに登録するか、ターミナルを ~/.codex/config.toml.
codex mcp add deuna-docs --url https://docs.deuna.com/api/mcp[mcp_servers.deuna-docs]
url = "https://docs.deuna.com/api/mcp"Gemini CLI#
ターミナルをサーバーに登録するか、ターミナルを ~/.gemini/settings.json.
gemini mcp add --transport http deuna-docs https://docs.deuna.com/api/mcp{
"mcpServers": {
"deuna-docs": {
"httpUrl": "https://docs.deuna.com/api/mcp"
}
}
}実行 /mcp Gemini CLI 内で、ツールがロードされていることを確認します。
その他のエージェント#
Streamable HTTP を介してリモート MCP サーバーをサポートするクライアントは、エンドポイント URL を使用して接続できます。 標準 (stdio) サーバーのみをサポートするクライアントは、 mcp-remote をブリッジとして使用できます: npx mcp-remote <endpoint>.
サーバーが#
利用可能なツールを、生の JSON-RPC リクエストを使用してリストします:
curl -X POST https://docs.deuna.com/api/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'const response = await fetch("https://docs.deuna.com/api/mcp", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Accept": "application/json, text/event-stream"
},
body: JSON.stringify({
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
})
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();import requests
response = requests.request(
"POST",
"https://docs.deuna.com/api/mcp",
headers={
"Content-Type": "application/json",
"Accept": "application/json, text/event-stream"
},
json={
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
},
)
response.raise_for_status()
data = response.json()<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://docs.deuna.com/api/mcp",
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Accept: application/json, text/event-stream"
],
CURLOPT_POSTFIELDS => json_encode([
"jsonrpc" => "2.0",
"id" => 1,
"method" => "tools/list"
])
]);
$response = curl_exec($curl);
curl_close($curl);import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Example {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://docs.deuna.com/api/mcp"))
.header("Content-Type", "application/json")
.header("Accept", "application/json, text/event-stream")
.method("POST", HttpRequest.BodyPublishers.ofString("{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}"))
.build();
HttpResponse<String> response = HttpClient.newHttpClient().send(
request, HttpResponse.BodyHandlers.ofString()
);
System.out.println(response.body());
}
}package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
request, err := http.NewRequest("POST", "https://docs.deuna.com/api/mcp", strings.NewReader("{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}"))
if err != nil { panic(err) }
request.Header.Set("Content-Type", "application/json")
request.Header.Set("Accept", "application/json, text/event-stream")
response, err := http.DefaultClient.Do(request)
if err != nil { panic(err) }
defer response.Body.Close()
body, _ := io.ReadAll(response.Body)
fmt.Println(string(body))
}正常なサーバーでは、ドキュメント、API リファレンス、プロバイダー機能に関する 5 つの読み取り専用ツールがすべて次の場所に返されます result.tools.
トラブルシューティング#
- ブラウザのタブに次の内容が表示される:
method_not_allowed: これは、ブラウザのナビゲーションがGETを使用するため想定どおりです。MCP クライアントに URL を設定するか、上記のPOST検証リクエストを使用してください。 - クライアントがローカルで接続できない: 実行してください:
npm run apiDocusaurus 開発サーバーと同時に実行します。ローカルページは意図的に MCP クライアントを次へ接続します:http://localhost:3001/api/mcp. - デプロイ済みクライアントで接続エラーが報告される: URL の末尾が次であることを確認してください:
/api/mcp。また、公開 HTTPS を使用し、クライアントのネットワークから到達可能であることを確認します。サーバーはステートレスなため、セッション識別子を保持する必要はありません。 - サーバーは応答するが質問への回答がない: 返されたツールがクライアントで有効になっていることを確認してください。サーバーはモデルの一般知識で回答せず、情報が文書化されていないことを明示します。