# Troubleshooting DIDWW MCP

Use the following guidance to resolve common DIDWW MCP connection,
authorization, account, upload, export, and request issues.

## Connection and authorization

The DIDWW authorization page does not open

1. Keep the MCP client open.
2. Check whether the browser opened the authorization page in another tab or
   window.
3. Return to the MCP client and start the connection again.
4. Confirm that the MCP client uses the server address published in
   [Connection details](connection-details.html).

If the page still does not open, follow the connection guide for your MCP
client or contact DIDWW Customer Support.

The Authorize button is unavailable

Review the authorization notice and select the acknowledgment checkbox. The
**Authorize** button becomes available after you accept the notice.

Two-factor authentication fails

1. Sign in to the DIDWW User Panel in your browser.
2. Complete two-factor authentication using a method enabled for your
   DIDWW user.
3. Return to the MCP client.
4. Start the connection again.

If you cannot complete two-factor authentication in the User Panel, resolve
the account-access problem before reconnecting the MCP client.

DIDWW appears disconnected

Reconnect DIDWW from the MCP client's connection or connector settings. If
the problem continues:

1. Open the account switcher in the DIDWW User Panel.
2. Select **Account Settings**.
3. Select the **MCP Clients** tab.
4. Revoke the affected connection when it is still listed.
5. Add or select DIDWW in the MCP client and complete authorization again.

The connection was revoked

A revoked connection cannot be restored. Add or select the DIDWW connection
in the MCP client and complete the browser authorization process again.

Authorization expired after inactivity

A connection that remains unused for 30 days requires DIDWW authorization
again. Reconnect DIDWW in the MCP client and complete the browser
authorization process.

## Accounts, permissions, and limits

The wrong DIDWW account is active

Ask the MCP client:

```
Which DIDWW account is currently active?
```

If you can access multiple accounts, ask it to list them and switch to the
required account. Confirm the active account before retrying the request.

An action is not permitted

The MCP client uses the roles and permissions of the DIDWW user who
authorized the connection. Check:

- the active DIDWW account
- your role for that account
- whether the record belongs to the active account
- whether the required service is enabled

Connecting an MCP client does not grant additional roles or permissions.

A service or account limit was reached

The requested action cannot be completed because a limit applies to the
active account or service. Review the response to identify the affected
limit and any available next steps.

Contact DIDWW Customer Support if the limit needs to be reviewed or changed.

The account balance is insufficient

DIDWW does not complete a purchase when the active account has insufficient
funds.

1. Add funds using a payment method in the DIDWW User Panel.
2. Return to the MCP client.
3. Review the updated balance.
4. Request a new purchase preview.

Too many requests were sent

DIDWW returns a waiting period when the connected MCP client exceeds its
request rate. Wait for the number of seconds identified by the MCP client or
the `Retry-After` value before sending another request.

## Uploads and exports

A secure upload link expired

A secure upload link cannot be used after it expires or after an upload is
completed. Ask the MCP client to create a new secure upload link.

Do not send documents in the MCP client conversation.

An export is still processing

Ask the MCP client to check the export status. Do not create another export
unless the original request failed.

An export link does not open the file

An export offers two links. The direct link opens the file without a DIDWW
User Panel sign-in. The User Panel link requires a signed-in DIDWW user that
can access the account associated with the export.

If the direct link does not open, ask the MCP client for the link again.
Chat clients sometimes append punctuation to a link and break it.

Completed export files remain available for one month, and both links stop
working when the file is deleted. Create a new export when the previous file
is no longer available.

## Requests and actions

A confirmed action has an unclear result

Do not immediately repeat a purchase, termination, restoration, invitation,
or deletion.

Ask the MCP client to check the relevant phone numbers, capacity, orders,
trunks, groups, identities, addresses, or invitations. Start another
request only when the account records show that the original action did not
complete.

A newly released action is missing

An MCP client can cache the available DIDWW actions for up to one hour.
Reconnect the client when a newly released action is missing or a previously
valid setting is no longer recognized.

An action is not available through MCP

Use the DIDWW User Panel when an action is not supported through MCP.
Current examples include:

- number porting
- A2P SMS campaigns
- CNAM configuration
- outbound trunks (Voice OUT)
- shopping-cart actions
- phone.systems(TM) subscription management
- company details

## Reconnect DIDWW MCP

1. Open the connection or connector settings in the MCP client.
2. Select or add DIDWW.
3. Complete the DIDWW browser authorization process.
4. Ask the MCP client to identify the active DIDWW account.

## Contact support

If the problem continues, contact [DIDWW Customer Support](mailto:support%40didww.com) by email. To speak with a 24/7
live support agent, open
the [DIDWW contact page](https://www.didww.com/contacts) and use the live-chat
widget.

Include the affected DIDWW account, MCP client name, approximate time of the
problem, and the error message.

Note

Do not include passwords, API keys, two-factor authentication codes, or documents.

On this page
