Skip to content

Commit f386e21

Browse files
committed
clarify how to use operation collections as tools
1 parent deaa12f commit f386e21

File tree

1 file changed

+10
-9
lines changed

1 file changed

+10
-9
lines changed

docs/source/define-tools.mdx

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -48,24 +48,25 @@ You can also use the `operations` option to specify a directory. The server then
4848

4949
Files and directories specified with `operations` are hot reloaded. When you specify a file, the MCP tool is updated when the file contents are modified. When you specify a directory, operations exposed as MCP tools are updated when files are added, modified, or removed from the directory.
5050

51-
### From Operation Collection
51+
### From an operation collection
5252

53-
For graphs managed by GraphOS, Apollo MCP Server can get operations from an [Operation Collection](https://www.apollographql.com/docs/graphos/platform/explorer/operation-collections).
53+
For graphs managed by GraphOS, Apollo MCP Server can get operations from an [operation collection](/graphos/platform/explorer/operation-collections).
5454

55-
To use a GraphOS Operation Collection, you must:
55+
To use a GraphOS operation collection, you must set your graph credentials `APOLLO_GRAPH_REF` and `APOLLO_KEY` as environment variables.
5656

57-
- Set `APOLLO_GRAPH_REF` and `APOLLO_KEY` environment variables for a GraphOS graph
57+
Use the `operations.source: collection` option to specify that tools should be loaded from an operation collection.
58+
59+
Specify the collection to use with the `operations.id` option. To view the ID of a collection, click the ••• button next to its entry, select **View details**, and copy the **Collection ID**.
5860

59-
Each variant will have its own default MCP Tools Collection, but you can specify any shared collection by using `operations` with `operations.source: collection`.
60-
Apollo MCP Server automatically fetches the default collection if no ID is specified.
61+
Each graph variant has its own default collection called **MCP Tools**. To use this default collection, specify `operations.id: default`.
6162

62-
```yaml title="Example config file for using a GraphOS Operation Collection"
63+
```yaml title="Example config file for using the default MCP Tools operation collection"
6364
operations:
6465
source: collection
65-
id: <collection-id>
66+
id: default
6667
```
6768
68-
The MCP Server supports hot reloading of the GraphOS Operation Collection, so it can automatically pick up changes from GraphOS without restarting.
69+
The MCP Server supports hot reloading of the GraphOS operation collection, so it can automatically pick up changes from GraphOS without restarting.
6970
7071
### From persisted query manifests
7172

0 commit comments

Comments
 (0)