feat: Add administrative tools for user, group, content, and site management #305
Open
allisonbierschenk wants to merge 3 commits into
Open
feat: Add administrative tools for user, group, content, and site management #305allisonbierschenk wants to merge 3 commits into
allisonbierschenk wants to merge 3 commits into
Conversation
…port Reorganizes all MCP admin tools under src/tools/admin/ structure: - admin/users/: User lifecycle, OAuth credentials, CSV bulk operations - admin/groups/: Group/group set management, membership operations - admin/content/: Projects, workbooks, views operations - admin/jobs/: Background job monitoring - admin/operations/: Job conflict detection, workbook archiving - admin/permissions/: Content permission management Adds three tool groups (admin, content, operations) that work with INCLUDE_TOOLS and EXCLUDE_TOOLS environment variables for granular access control. Tools can be filtered by individual name or group name.
… Projects, workbooks, views operations jobs/: Background job monitoring operations/: Job conflict detection, workbook archiving permissions/: Content permission management Adds tool groups that work with INCLUDE_TOOLS and EXCLUDE_TOOLS environment variables for granular access control. Tools can be filtered by individual name or group name. New tools support comprehensive site administration and content management operations through organized, scoped interfaces.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
IMPORTANT: Please do not create a Pull Request without creating an issue first.
Any change needs to be discussed before proceeding. Failure to do so may result in the rejection of
the pull request.
Pull Request Template
Description
This PR adds 8 new administrative tools for managing Tableau users, groups, content, permissions, and site operations. All tools are
organized under
src/tools/admin/with corresponding API methods, tests, and documentation.New Tools
User & Group Administration:
admin-users- User lifecycle management (create, update, delete, query), CSV import/export, and OAuth credential managementadmin-groups- Group and group set management with membership operationsContent Management:
content-projects- Create, update, delete, and query projects with filtering and paginationcontent-workbooks- Query, update, delete, and download workbooks for site or specific userscontent-views- Query views and export data in multiple formats (CSV, image, PDF, Excel)Permissions & Operations:
content-permissions- Manage granular and default permissions for datasources, projects, views, workbooks, and other contenttypes
site-jobs- Query and cancel background jobs on the sitetableau-operations- Advanced operations including job conflict detection, effective permissions analysis, stale contentreports, lineage impact analysis, and workbook archiving
New Tool Groups:
Adds three tool groups for the new tools:
admin- admin-users, admin-groupscontent- content-projects, content-workbooks, content-viewsoperations- content-permissions, site-jobs, tableau-operationsMotivation and Context
Tableau administrators need programmatic access to administrative functions beyond data querying and content exploration. These
tools enable:
Customers like Walmart, IAS (Integrated Ad Science), & Amplitude have expressed a need for this.
Type of Change
How Has This Been Tested?
Unit Tests:
Admin-Users Tool (16 tests):
credentials
Admin-Groups Tool (9 tests):
Other Admin Tools (10 tests):
Integration Testing:
Backward Compatibility:
Related Issues
NA
Checklist
npm run version. For example,use
npm run version:patchfor a patch version bump.environment variable or changing its default value.
Contributor Agreement
By submitting this pull request, I confirm that:
its Contribution Checklist.