Integration Within Claude Desktop Instructions

Claude桌面指令中的MCP服务器集成

创建虚拟阿波罗图并获取凭据

1. 在您的首选位置为Apollo Graph项目创建一个空目录
2. 打开终端并导航到此目录的根目录
3. 运行漫游车初始化以初始化新的阿波罗图
4. 按照终端中出现的提示设置图形
5. 成功创建后，将显示您的APOLLO_GRAPH_REF和APOLLO_KEY凭据-复制并安全保存这些值
6. 在项目目录中，找到supergraph.yaml文件，并将其全部内容替换为：

   federation_version: =2.10.0
   subgraphs:
     listings:
       routing_url: https://rt-airlock-subgraphs-listings.herokuapp.com/
       schema:
         subgraph_url: https://rt-airlock-subgraphs-listings.herokuapp.com/	

- 此配置使用示例API，这些API提供阿波罗MCP教程中的宇宙飞船数据

克隆和运行Apollo运行时容器

1. 从以下位置克隆Apollo Runtime存储库：https://github.com/apollographql/apollo-runtime?tab=readme-ov文件
2. 导航到克隆存储库的根目录，并验证Docker Desktop是否正在运行
3. 执行以下命令，用实际凭据替换INSERT_HERE：

docker run \
--env APOLLO_GRAPH_REF="INSERT_HERE" \
--env APOLLO_KEY="INSERT_HERE" \
--env MCP_ENABLE=1 \
--env MCP_UPLINK=1 \
--rm \
-p 4000:4000 \
-p 5050:5000 \
ghcr.io/apollographql/apollo-runtime:latest

1. 成功执行后：

- 访问localhost:4000访问GraphQL API端点 - 访问studio.apollographql.com/sandbox？端点=http://localhost:4000访问Apollo Studio资源管理器以创建和测试查询

运行MCP服务器并连接到Claude桌面

1. 在Apollo图形项目中，创建一个名为operations的新文件夹
2. 在操作文件夹中，创建一个名为listings.graphql的文件，并添加以下示例查询：

  query ExampleQuery {
  products {
    name
    description
    id
  }
}

1. 从项目根目录运行以下命令启动MCP服务器：

rover dev --supergraph-config ./supergraph.yaml `
  --mcp `
  --mcp-operations ./operations/listings.graphql

1. 启动Claude Desktop并从应用程序菜单访问设置
2. 导航到“开发人员”部分，然后单击“编辑配置”
3. 使用以下配置更新claude_desktop_config文件：

{
  "mcpServers": {
    "airlock": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://127.0.0.1:5000/mcp",
        "--transport",
        "http-first"
      ]
    }
  }
}

1. 重新启动Claude Desktop以保存这些更改
2. 返回Claude Desktop并启用界面中显示的新工具。您现在可以要求Claude执行API查询，并从Apollo图中接收结果