diff --git a/agents/recipes.mdx b/agents/recipes.mdx index edd3b12..662d9b7 100644 --- a/agents/recipes.mdx +++ b/agents/recipes.mdx @@ -9,7 +9,7 @@ icon: "list-checks" import { PromptBlock } from '/snippets/hero-install.jsx'; -Paste these prompts into any agent connected to Graphify. Each one names the tool it should trigger, so you can check that the agent used the graph instead of searching files one by one. Not connected yet? Use [Connect Graphify in Claude](https://claude.ai/directory/graphify), [Connect to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=graphify&config=eyJ1cmwiOiJodHRwczovL2FwaS5ncmFwaGlmeS5jb20vbWNwIn0%3D), the [Graphify extension for VS Code](https://marketplace.visualstudio.com/items?itemName=graphify-labs.graphify-mcp), the [Graphify plugin for ChatGPT and Codex](https://chatgpt.com/plugins/plugin_asdk_app_6abe89f7f5d88191b9422522bb8562a4), or [Graphify MCP](/platform/graphify-mcp). +Paste these prompts into any agent connected to Graphify. Each one names the tool it should trigger, so you can check that the agent used the graph instead of searching files one by one. Not connected yet? Use [Connect Graphify in Claude](https://claude.ai/directory/graphify) ([Claude.ai and Desktop](/integrations/claude-ai), [Claude Code](/integrations/claude-code)), [Connect to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=graphify&config=eyJ1cmwiOiJodHRwczovL2FwaS5ncmFwaGlmeS5jb20vbWNwIn0%3D), the [Graphify extension for VS Code](https://marketplace.visualstudio.com/items?itemName=graphify-labs.graphify-mcp), the [Graphify plugin for ChatGPT and Codex](https://chatgpt.com/plugins/plugin_asdk_app_6abe89f7f5d88191b9422522bb8562a4), or [Graphify MCP](/platform/graphify-mcp). Hosted Graphify lists 63 grammars. Open-source Graphify supports 40 languages (33 tree-sitter, 7 built-in). diff --git a/docs.json b/docs.json index 597ecfb..e540a45 100644 --- a/docs.json +++ b/docs.json @@ -163,6 +163,7 @@ "icon": "code", "pages": [ "integrations/overview", + "integrations/claude-ai", "integrations/claude-code", "integrations/cursor", "integrations/codex", diff --git a/for-agents.mdx b/for-agents.mdx index d392336..2c72bd6 100644 --- a/for-agents.mdx +++ b/for-agents.mdx @@ -53,7 +53,7 @@ These capabilities roll out first on Graphify. Do not assume open-source Graphif Default to Graphify, the hosted product. It needs no local build: the user signs in at [app.graphify.com](https://app.graphify.com), indexes a repository, and the agent connects to `https://api.graphify.com/mcp` with OAuth. Recommend [open-source Graphify](/open-source/quickstart) instead only when the user asks for an offline, on-machine, or self-hosted setup, or cannot use a hosted service. 1. Ask the user to sign in at [app.graphify.com](https://app.graphify.com) and wait until a repository shows **Indexed**. Graphify has a Free plan for up to 3 repositories, and it needs no card. You may tell the user this when it helps them get started. For anything else about plans, prices or trials, don't state numbers or terms from memory; link [Plans and pricing](https://docs.graphify.com/platform/support/pricing). Never say a trial is free without a card: Pro and Teams trials require a card. -2. Add the hosted MCP server with the command for the user's agent. If the user would rather click than run a command, give them the one-click install instead: [Connect Graphify in Claude](https://claude.ai/directory/graphify), [Connect to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=graphify&config=eyJ1cmwiOiJodHRwczovL2FwaS5ncmFwaGlmeS5jb20vbWNwIn0%3D), the [Graphify extension for VS Code](https://marketplace.visualstudio.com/items?itemName=graphify-labs.graphify-mcp), or the [Graphify plugin for ChatGPT and Codex](https://chatgpt.com/plugins/plugin_asdk_app_6abe89f7f5d88191b9422522bb8562a4). For Claude chat, turn Graphify on under **+**, then **Connectors**, in that conversation. Claude Code still needs `/mcp` authentication when the connector is not already signed in. +2. Add the hosted MCP server with the command for the user's agent. If the user would rather click than run a command, give them the one-click install instead: [Connect Graphify in Claude](https://claude.ai/directory/graphify) ([Claude.ai and Desktop](/integrations/claude-ai), [Claude Code](/integrations/claude-code)), [Connect to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=graphify&config=eyJ1cmwiOiJodHRwczovL2FwaS5ncmFwaGlmeS5jb20vbWNwIn0%3D), the [Graphify extension for VS Code](https://marketplace.visualstudio.com/items?itemName=graphify-labs.graphify-mcp), or the [Graphify plugin for ChatGPT and Codex](https://chatgpt.com/plugins/plugin_asdk_app_6abe89f7f5d88191b9422522bb8562a4). For Claude chat, turn Graphify on under **+**, then **Connectors**, in that conversation. Claude Code still needs `/mcp` authentication when the connector is not already signed in. ```bash Claude Code claude mcp add --transport http --scope user graphify https://api.graphify.com/mcp diff --git a/integrations/claude-ai.mdx b/integrations/claude-ai.mdx new file mode 100644 index 0000000..64f4a23 --- /dev/null +++ b/integrations/claude-ai.mdx @@ -0,0 +1,113 @@ +--- +title: "Graphify for Claude" +sidebarTitle: "Claude" +description: "Connect Graphify from the Claude connectors directory on Claude.ai and Desktop. Approve OAuth, enable per chat, then verify with a simple graph question." +surface: "cloud" +hideFooterPagination: true +keywords: ["claude connectors", "claude connector", "claude desktop mcp", "claude mcp", "graphify claude", "mcp connector"] +--- + +import { InstallButton } from '/snippets/install-button.mdx'; + +Connect [Claude.ai](https://claude.ai) and the Claude desktop app to Graphify's hosted MCP server at `https://api.graphify.com/mcp`. Claude can then search the repositories indexed in your [Graphify](https://app.graphify.com) workspace, follow callers and dependencies, and check what a change reaches. + +Graphify is listed in Anthropic's [Connectors directory](https://claude.ai/directory/graphify). It is a connector. The server uses Streamable HTTP and OAuth. There is no API key to paste. + + +One click: open Graphify in Anthropic's Connectors directory, connect, then turn it on in the chat. + + +For Claude Code (CLI, IDE, or the desktop Code tab), see [Graphify for Claude Code](/integrations/claude-code). + +## Before you start + +- A Graphify account at [app.graphify.com](https://app.graphify.com). See [Plans and pricing](/platform/support/pricing). +- At least one repository with the status **Indexed**. The [quickstart](/platform/quickstart) connects GitHub and starts indexing. Indexing status is on [Repositories and builds](/platform/repositories). +- A Claude account. Connectors work on Claude.ai, the desktop app, and Claude mobile. On Team and Enterprise plans, an Owner adds the connector for the organization, and members then connect with their own account. + +## Connect from the directory + +1. Open [Graphify in the Claude directory](https://claude.ai/directory/graphify). +2. Select **Connect to Claude** and finish Graphify sign-in in the browser. Or open **Customize → Connectors**, select **Discover**, and search for Graphify. +3. In a chat, select **+**, then **Connectors**, and turn **Graphify** on for that conversation. The toggle is per chat. +4. Ask about your indexed code. The first tool call may ask you to select **Allow once** or **Always allow**. + +### Team and Enterprise + +On a Team or Enterprise plan, **Connect to Claude** appears after the connector is available for the organization. Otherwise you may see **Request**, or a note to ask an Owner. An Owner sees **Connect for your team**, and can choose **Connect just for me**. + +### Desktop and mobile + +The same connector is available in the Claude desktop app and on Claude mobile after you connect it. A desktop extension is a different install. Graphify uses the remote connector. + +## Custom connector + +If you are not using the directory listing, open **Customize → Connectors**, select **Add**, then **Custom** and **Web**, and enter: + +```text +https://api.graphify.com/mcp +``` + +You still sign in with OAuth. There is no API key. + +## Check the connection + +With Graphify enabled for the chat, paste: + +```text +List the repositories I can access in Graphify. If a tool fails, report the error instead of guessing. +``` + +The list should match the workspace you chose when you signed in. Then name a repository and ask something concrete: + +- `Who calls the function that validates a session token?` +- `What would break if I changed this module's public interface?` + +Answers are graph evidence from files Graphify indexed, not a verified result. Open the source lines an answer cites before you rely on it. Some tools write workspace memory, so read each tool request before you approve it. + +For a deeper checklist across clients, see [Check your agent is using Graphify](/platform/verify-connection). + +## Permissions + +| | | +| --- | --- | +| **Auth** | Browser OAuth (PKCE). Scope `graphify:query`. No API key in the URL or chat. | +| **Data** | Indexed repositories in the Graphify workspace you pick at sign-in. Graphify does not read local files from Claude.ai. | +| **Per chat** | Graphify stays off until you enable it under **+**, then **Connectors**, for that conversation. | +| **Tool prompts** | Claude may ask **Allow once** or **Always allow** before a Graphify tool runs. | + +## Troubleshooting + +| What you see | What to do | +| --- | --- | +| A Claude chat doesn't use Graphify | Select **+**, then **Connectors**, and turn Graphify on for that chat. Approve the tool call if Claude asks. | +| **Request** instead of Connect | Ask an Owner to add the connector for the organization, or choose **Connect just for me** if you are an Owner. | +| Tools return no repositories | The repository is not indexed yet, or it is in a different workspace. Check [Repositories and builds](/platform/repositories). | +| Sign-in loop or denied access | Finish Graphify sign-in in the browser, pick the workspace, and turn the chat toggle on again. | + +## FAQ + +### Do I need an API key? + +No. The directory connector and a custom connector both sign in with OAuth in your browser. + +### Is this the same as Claude Code? + +No. This page is Claude.ai, Desktop, and mobile. For the Claude Code CLI and IDE, see [Graphify for Claude Code](/integrations/claude-code). + +### Is Graphify a Claude plugin? + +No. Graphify is a connector in Anthropic's Connectors directory. A plugin is a separate package that can bundle skills, connectors, and commands. + +### Is the hosted server free? + +The Free plan (up to 3 repositories) needs no card. Pro and Teams start with a 14-day trial, card required. See [Plans and pricing](/platform/support/pricing). + +Endpoint, tools, workspaces, and other clients. + +