> For the complete documentation index, see [llms.txt](https://docs.veedna.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.veedna.com/lineaje-mcp-server/troubleshooting.md).

# Troubleshooting

Fix common problems connecting to or using the Lineaje MCP server.

## The browser sign-in does not open

* Look for a sign-in URL in your IDE or terminal output and open it manually.
* In Antigravity and Augment, the sign-in starts from a pop-up. Click **Open** when it appears. In Augment, the pop-up can take a few seconds.
* Check that your browser isn't blocking pop-ups from your IDE.

## Sign-in loops or fails

* Confirm you can log in to the Lineaje Portal directly in your browser.
* The sign-in returns to a `localhost` address on your machine. A local firewall, proxy, or VPN that blocks `localhost` connections can break this step.
* Remove the `Lineaje-MCP-Server` server from your IDE, add it again, and repeat the sign-in.

## Tools do not appear in the IDE

* Disable the `Lineaje-MCP-Server` server in your IDE's MCP settings, then enable it again.
* In Cursor, select a specific agent model instead of **Auto**.
* Check the config key. Antigravity uses `serverUrl`. Cursor and most other IDEs use `url`.
* Check the URL ends in `/mcp`.

## A tool is missing

Each tool needs a product license: SBOM360 for `sbom_search` and UnifAI for `security_workflow`. If one tool is missing, your organization probably isn't licensed for that product. See [Licenses and tool visibility](https://docs.veedna.com/lineaje-mcp-server/authentication-and-access.md#licenses-and-tool-visibility).

## A query returns no results

* Results cover only the organizations your account belongs to. The product or SBOM may sit in an organization you can't access.
* A newly uploaded SBOM appears only after SBOM360 finishes processing it.
* Compare the row count in the response with the rows shown. If the count is higher, ask for more rows or the next page.
* Rephrase the question, or pass an LQL query directly.
* For `security_workflow`, check that [policies are enabled](https://docs.veedna.com/unifai/policies/viewing-and-enabling-policies.md). Policies are disabled by default.

## Get help

{% hint style="danger" %}
NEEDS INPUT: support contact or channel for MCP server issues.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.veedna.com/lineaje-mcp-server/troubleshooting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
