Graphify for Claude Code

Pick the tab that matches how you run Graphify: Graphify (hosted) connects to the graph we build for you, Graphify Local reads a graph you build on your machine. Compare them.

Graphify (hosted)
Graphify Local

Connect Claude Code to Graphify’s hosted MCP server at https://api.graphify.com/mcp. Claude Code can then search the repositories indexed in your Graphify workspace, follow callers and dependencies, and check what a change reaches, without re-reading every file.The server uses Streamable HTTP and OAuth. You sign in once in the browser, so there is no API key to paste and no local process to run.

Before you start

A Graphify account at app.graphify.com. New accounts start on a 14-day Pro trial, then move to Free (up to 3 indexed repositories). No card is required.
At least one repository with the status Indexed. The quickstart connects GitHub and starts indexing. Indexing status is on Repositories and builds.

1. Add the server

Run this in a terminal, not inside a Claude Code session:

claude mcp add --transport http --scope user graphify https://api.graphify.com/mcp

--scope user adds Graphify for your user, so it works in every project. The hosted server is per account, not per repository. To keep it to one folder, drop --scope user and Claude Code uses local scope.To share the server with everyone who clones a repository, commit this .mcp.json at the repository root instead:

.mcp.json

{
  "mcpServers": {
    "graphify": {
      "type": "http",
      "url": "https://api.graphify.com/mcp"
    }
  }
}

Each teammate approves the project server once, then signs in as in step 2.Adding the server does not sign you in. Until you do, Claude Code lists graphify as needing authentication and no tool call reaches Graphify.

Open the MCP panel

Start Claude Code and run /mcp.

Authenticate

Select graphify and choose Authenticate. Finish the sign-in in the browser window that opens, and pick the workspace that holds your repositories.

3. Check the connection

Run claude mcp list in a terminal. graphify should show Connected. Then paste this into Claude Code:

Use Graphify's list_repositories tool and show the repositories I can access. If the tool fails, report the error instead of guessing.

This is the same test prompt the console shows on Connectors → MCP → Try a query. Check that the list matches the workspace you chose when you signed in.

Optional: set a default repository

Add ?repo=owner/name to the endpoint, for example https://api.graphify.com/mcp?repo=Graphify-Labs/graphify. Graphify uses that repository when a tool call names none. A repository named in the call still wins.

4. Ask a question

Pick a repository from the list and name the symbol, file, or area you care about:

Who calls the function that validates a session token?
What would break if I changed this module's public interface?
Summarize how requests reach the billing service.

Answers are graph evidence from the 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.

Troubleshooting

What you see	What to do
`graphify` shows Needs authentication	Run `/mcp`, select graphify, and choose Authenticate.
Graphify works in one project but not another	You added it at local scope. Run the add command again with `--scope user`.
Pending approval next to `graphify`	It comes from a project `.mcp.json`. Start `claude` in that repository and approve it.
The tools return no repositories	The repository is not indexed yet, or it is in a different workspace. Check Repositories and builds.
Every Graphify tool appears twice	You have both a user-scope entry and a project `.mcp.json` entry. Remove one with `claude mcp remove graphify`.

FAQ

Do I need an API key to connect Claude Code to Graphify?

No. Claude Code signs in with OAuth in your browser the first time it connects. There is no key to paste or store.

Does Graphify read my local files from Claude Code?

No. The hosted server answers from repositories already indexed in your Graphify workspace. To build a graph from files on your machine instead, use the open-source package and its local skill.

Is the Graphify MCP server free?

Every new account starts on a 14-day Pro trial. After the trial, the Free plan keeps the hosted server available for up to 3 indexed repositories, with no card required. See Plans and pricing for Pro and Teams.

Can I use the hosted server and the local Graphify skill together in Claude Code?

Yes, but they answer from different graphs. The hosted server reads your indexed workspace. The local skill reads graphify-out/ in the repository. Pick one per question so answers stay consistent.

1. Install and register

uv tool install graphifyy
graphify install --platform claude

The integration writes Claude instructions and PreToolUse hooks that suggest consulting the graph for codebase questions. Exact destinations depend on whether you use a personal or project installation; the installer reports the files it writes.For a repository-local setup, run this from the project root:

graphify install --project --platform claude

2. Build the graph

Open your project in Claude Code. Select the Graphify skill and enter:

/graphify .

The assistant runs the Graphify workflow and writes graphify-out/. Code extraction runs locally; semantic extraction can use your assistant’s model for documents and media.

3. Ask with context

After the graph is built, ask:

Use Graphify to explain the authentication flow. Cite the source files and distinguish explicit relationships from inferred ones.

You can also query from a terminal:

graphify query "authentication flow"

Keep it current

uv tool upgrade graphifyy
graphify install --platform claude

If the skill is missing, refresh the assistant and confirm that the registration was installed in the intended user or project scope. See troubleshooting.

Connect native MCP tools

Use the same graph through structured tool calls.

Graphify with Claude Code (local skill)

Build the graph on your machine with the open-source local skill instead.

How Graphify builds a code knowledge graph

What the graph contains and where its relationships come from.

Edges and provenance

Read what an answer’s relationships claim and how certain they are.

Code with an agent

Set up any agent from the console’s Connectors → MCP wizard.

Coding agents

Assistants

Source control

CI and deploy

Knowledge sources

For agents

Graphify for Claude Code

Before you start

1. Add the server

3. Check the connection

Optional: set a default repository

4. Ask a question

Troubleshooting

FAQ

Do I need an API key to connect Claude Code to Graphify?

Does Graphify read my local files from Claude Code?

Is the Graphify MCP server free?

Can I use the hosted server and the local Graphify skill together in Claude Code?

1. Install and register

2. Build the graph

3. Ask with context

Keep it current

Connect native MCP tools

Graphify with Claude Code (local skill)

How Graphify builds a code knowledge graph

Edges and provenance

Code with an agent

​Before you start

​1. Add the server

​2. Sign in

​3. Check the connection

​Optional: set a default repository

​4. Ask a question

​Troubleshooting

​FAQ

​Do I need an API key to connect Claude Code to Graphify?

​Does Graphify read my local files from Claude Code?

​Is the Graphify MCP server free?

​Can I use the hosted server and the local Graphify skill together in Claude Code?

​1. Install and register

​2. Build the graph

​3. Ask with context

​Keep it current

Connect native MCP tools

​Related

Graphify with Claude Code (local skill)

How Graphify builds a code knowledge graph

Edges and provenance

Code with an agent

Before you start

1. Add the server

2. Sign in

3. Check the connection

Optional: set a default repository

4. Ask a question

Troubleshooting

FAQ

Do I need an API key to connect Claude Code to Graphify?

Does Graphify read my local files from Claude Code?

Is the Graphify MCP server free?

Can I use the hosted server and the local Graphify skill together in Claude Code?

1. Install and register

2. Build the graph

3. Ask with context

Keep it current

Related