Skip to content
Last updated

NetDocuments integration

NetDocuments is a cloud document management platform used to store, organize, and search legal and professional documents.

It can be connected to Agen.co two ways, matching the Official / In-house filter in the connector picker:

  • Official — Agen.co connects through NetDocuments' own hosted MCP server, so your AI agents use the same document tools NetDocuments exposes to MCP clients like Claude. Each user signs in with their own NetDocuments account, and there is no application to register.
  • In-house — Agen.co wraps the NetDocuments REST API directly through its own integration layer, using a Developer Portal application you register with NetDocuments.

Pick Official if your repository has MCP access and the built-in tools cover what your agents need. Fall back to In-house if MCP is not available for your repository, or you need the REST API surface beyond it.


Connect via the official MCP server

Prerequisites

  • MCP access must be available for your NetDocuments repository, and a repository administrator must turn it on in the NetDocuments Admin Console (Security Center → ndConnect → Enable MCP for this repository). If you cannot find the setting, contact NetDocuments — it cannot be switched on from Agen.co.
  • A NetDocuments account that can access the repository. Each user signs in with their own account, and results are limited to what that user is allowed to see.
  • The data region your repository is hosted in.

NetDocuments supports dynamic client registration, so you do not register a Developer Portal application, copy a Client ID or Client Secret, or register a callback URL.

Connect NetDocuments in Agen.co

  1. In the Agen.co portal, go to Connectors → My connectors and click Add connector.

  2. Find NetDocuments and select it.

  3. In the Add NetDocuments panel, keep the Official tab selected and fill in the fields:

    FieldRequiredDescription
    Instance SlugYesNamespaces this instance — it prefixes each imported tool as slug__tool, so several instances of the same MCP can coexist. Prefilled with netdocuments. Use lowercase kebab-case. You can change it later from the connector's settings.
    NetDocuments regionYesThe region where your NetDocuments repository lives: us (United States, the default), de (Europe (Germany)), au (Australia), or ca (Canada).
  4. Click Connect. NetDocuments opens in a new tab, and the panel shows Waiting for authorization — complete it in the opened tab…

  5. On the NetDocuments Login page, sign in and approve the requested access.

  6. Back in Agen.co, the panel switches to Select the tools to import from NetDocuments. Every tool is toggled on; turn off any you don't want to import, then click Add.

The connector is created and its tools imported only when you click Add. If you close the panel before that, nothing is saved, even if the NetDocuments tab reported success.

Each connector instance connects to exactly one NetDocuments region. To connect repositories in more than one region, add the NetDocuments connector again with a different Instance Slug and the other region.

What it covers

Agen.co requests the three scopes the NetDocuments MCP server publishes. NetDocuments keeps the tool list behind sign-in, so the list is not reproduced here — the tool selection screen after Connect shows exactly what your repository serves.

ScopeWhat it allows
readRead and search cabinets, folders, and documents
organizeCreate folders and file documents
editRename and update documents and folders

Every result is filtered by what the signed-in user is allowed to see in NetDocuments, including ethical walls and matter-level restrictions.

Enabling the NetDocuments connector isn't enough on its own. Tool calls remain denied until you create a policy that grants access to the specific tools you want to expose.

Connect via the in-house integration

Prerequisites

  • A NetDocuments repository, and a repository administrator who can authorize the application
  • A NetDocuments Developer Portal account — this is not self-serve and must be requested from NetDocuments support before you can register an application
  • The data region your repository is hosted in: United States, European Union, Germany, or Australia

Connect NetDocuments

Step 1: Request a Developer Portal account

NetDocuments does not offer self-serve access to its Developer Portal. Sign in to NetDocuments support, choose Submit a Request, select API Support as the help-desk category, and use Request Dev Portal account as the subject. NetDocuments creates the account and emails you a sign-in link.

Your Developer Portal sign-in is separate from your everyday NetDocuments sign-in, even when both use the same email address.

Step 2: Register your application

Sign in to the Developer Portal and register a new application. Set the client type to Confidential — the integration keeps its credentials on the server and exchanges them for tokens directly, which a public client cannot do.

Give the application a name your repository administrator will recognize, for example Frontegg Integration.

Step 3: Add the redirect URL

In the application's settings, enter the redirect URL shown in the Frontegg portal for this integration — copy it whole, including the path. See How to get your Redirect URL.

The value has this shape, but take the real one from the portal rather than assembling it:

  • https://YOUR_MCP_GATEWAY_URL/integration-callback

The redirect URL must match exactly

NetDocuments compares the redirect URL in the authorization request against the registered value character for character, including the protocol and any trailing slash. A mismatch fails the connection before the consent screen appears.

Step 4: Note the OAuth scopes

The integration requests the three scopes below. Grant all three — the connection is authorized once for the whole integration, so a missing scope disables the matching operations rather than prompting again later.

ScopeDescription
readRead cabinets, folders, documents, workspaces, users, and groups, and run searches
organizeCreate folders and file documents into or out of them
editRename documents and folders, replace document content, and add new versions
Step 5: Copy your credentials

NetDocuments generates the Client ID and Client Secret when the application is registered. Copy both and store them somewhere safe — you will need them when configuring the integration in the Frontegg portal.

Keep your credentials secure

Treat the Client Secret like a password. Never share it or commit it to version control. If it is exposed, generate a new one in the Developer Portal and update the Frontegg portal.

Step 6: Have a repository administrator authorize the application

Before the application can reach a repository, a repository administrator must approve it and map your Client ID to the identity the application acts as inside that repository. Send the administrator your Client ID and the application name from step 2.

Until this mapping exists, the credentials are valid but every call is refused by the repository.

Configure the Frontegg portal

Once you have your Client ID and Client Secret from the steps above, enter them in the integration configuration page of the Frontegg portal:

  1. Open the Frontegg portal and navigate to [ENVIRONMENT] → Integrations → NetDocuments.
  2. Enter the Client ID and Client Secret in the corresponding fields.
  3. Select your Data region — United States, European Union, Germany, or Australia.
  4. Select the required scopes.
  5. Click Save.

The data region must match where you registered

NetDocuments runs separate regional services, and credentials are issued per region. A Client ID registered in the United States is not valid against the European Union, Germany, or Australia, so selecting the wrong region here fails the connection even when the credentials are correct.

Capabilities

  • Document content can be replaced in place without creating a new version, or added as a new version that leaves the previous one intact — the choice is yours per update.
  • A new version can be created by copying an existing version instead of uploading content again.
  • Searches can run against a single cabinet or across several cabinets at once, with paging for large result sets.
  • Invalid characters in a new folder name can be stripped automatically instead of failing the request.

Provider limitations

  • Document content can only be sent as text. Binary files — PDFs, images, Office documents — cannot be uploaded or replaced through the integration, though they can be downloaded, optionally encoded as text.
  • Every result is filtered by what the connected user is allowed to see. A short or empty list of cabinets, folder items, search results, or groups is not proof that nothing else exists — it may mean the connected user cannot see it.
  • Searches and container listings return at most 500 items per request, and a cabinet search returns 100 by default unless a higher limit is asked for.
  • Filing a document into a folder gives it the access rights of that folder, so organizing documents can change who is able to reach them.
  • Multi-cabinet search requires the cabinets to be named explicitly; there is no way to search every cabinet at once without listing them.
  • Identifiers are prefixed by type and are not interchangeable — cabinet identifiers begin with NG- and group identifiers with UG-. Supplying one where another is expected is rejected.
  • Renaming a document or folder changes only its name; contents, location, and version history are left as they are.

Additional resources